Skip to content

Customer Accounts

Enable passwordless customer accounts with OTP login

Updated View as Markdown

Allow customers to create accounts and access order history, manage addresses, upload documents such as a FOID card, and set their preferred FFL dealer — all with a simple one-time code login. No passwords required.


Features

Feature Description
Passwordless login Customers sign in with a 6-digit one-time code sent to their email
Order history View recent orders with their date, status, and total, and open each one
Profile management Update name, phone number, and marketing preferences
Shipping and billing addresses Save addresses for shipping and for billing, each with its own default
Documents Upload a FOID card, a driver’s license or state ID, or a CCW permit
FFL dealer selection Set a preferred FFL dealer for firearms purchases
Your design Arrange and restyle the account page in the Visual Editor

Enabling Customer Accounts

  1. Navigate to Settings > General
  2. Find the Customer accounts card
  3. Toggle Enable customer accounts on
  4. Click Save changes

Note: When enabled, a “Sign In” or “Account” link appears in your storefront navigation (depending on your theme).


How Login Works

Customer accounts use one-time passcode (OTP) authentication — no passwords to remember or reset.

Login Flow

  1. Customer clicks the account link on your storefront to reach the Sign in page
  2. Customer enters their email address and clicks Continue
  3. A 6-digit verification code is sent to their email
  4. Customer enters the code and clicks Verify (or uses Resend code if it never arrived)
  5. They’re signed in and redirected to their account dashboard — or straight back to checkout if that is where they came from

Security Details

Detail Value
Code length 6 digits
Code expiration 10 minutes
Max verification attempts 5 per code
Rate limit 5 codes per hour per email
Session duration 30 days

Tip: If a customer doesn’t have an account yet, one is automatically created when they first verify their email.


Customer Account Features

The account page is made of sections you can arrange and restyle. See Customizing the Account Page.

Order History

The Order history section lists the customer’s most recent orders (20 by default), showing:

  • Order number
  • Order date
  • Order status
  • Order total

Each order number opens the order’s page, where a signed-in customer doesn’t have to enter their email address first.

Profile Management

Customers can update their profile information:

Field Description
First name Customer’s first name
Last name Customer’s last name
Phone Contact phone number
Subscribe to marketing emails Opt in or out of marketing communications

The email address is fixed — it is the identity the customer signs in with. The section’s settings can hide the phone number or the marketing opt-in; hiding the opt-in leaves the customer’s choice as it is.

Shipping and Billing Addresses

Customers manage their addresses in two sections, Shipping addresses and Billing addresses:

  • Add an address with + Add address
  • Edit an address
  • Tick Use as my default shipping address (or billing) to make it the default checkout fills in
  • Remove an address with Remove

An address used for both, such as one saved at checkout with billing the same as shipping, shows in both sections. Removing it from one section keeps it for the other. Edits change it in both.

Tip: The first address added to each section becomes its default.

Documents

The Documents section lets customers upload a FOID card, a driver’s license or state ID, or a CCW permit:

  1. The customer clicks Upload next to the document and picks a JPG, PNG, GIF or PDF of up to 10MB
  2. The file is checked automatically. One that’s clearly not the document, such as a random photo, is turned away with a message at the top of the page, and nothing is saved. See Automatic Check on Customer Uploads
  3. Otherwise the file is saved to their customer files, and the row shows On file, uploaded with the date
  4. Your team gets the Customer document uploaded alert. See Notifications

A new upload never replaces or deletes an earlier one: every copy stays in the customer’s files, and the account shows the date of the latest. Customers never see or download a file back from their account.

A FOID card uploaded here counts as the card on file, so orders that need one don’t ask again, and the reminder email isn’t sent (see FOID Cards). A driver’s license or state ID counts as the photo ID Orchid eState asks for.

The documents listed are blocks you choose in the Visual Editor. The section starts with the FOID card and the driver’s license or state ID; you can add the CCW permit, remove one, or rename one. The FOID card is named the way your FFL rules name the card in the customer’s state, such as Firearms Purchaser Identification Card in New Jersey.

FFL Dealer Selection

The Preferred FFL dealer section shows the dealer checkout picks for the customer. Customers can:

  • Search for FFL dealers by name (at least 3 characters) or by 5-digit ZIP code, with a search radius
  • Set a preferred FFL location for future orders
  • Remove their FFL preference

This saves customers time at checkout: when a cart has no dealer chosen yet, the customer’s preferred FFL is pre-selected.

Events and Subscriptions

If your store uses the Events or Reload (subscriptions) plugins, the account page also shows My registrations and My subscriptions, where customers manage the classes they signed up for and their recurring orders. Each section is added when its plugin is turned on.


Customizing the Account Page

  1. Go to Store > My Store and click Customize on your theme
  2. Choose Customer Account in the template selector
  3. Reorder, hide or remove sections, change their headings and labels, or add sections back from the Customer account category of Add section
  4. Click Save

The editor shows the page with a sample customer, Jordan Sample, since nobody is signed in there. The Account header section stays on the page: it holds the Log out button and the page’s messages, and sets the page width and popup colours for the other sections. See Customer Account Sections for each section.

The Sign in page and each order’s page come from FirearmCart rather than your theme, so you can’t edit them in the Visual Editor. If your theme was made for Shopify, its own sign-in, order and address templates are never shown to customers, so the template selector leaves them out.


Troubleshooting

Customer Not Receiving Code

Symptoms: Customer doesn’t receive the verification email

Solutions:

  • Check the customer’s spam/junk folder
  • Verify the email address is correct
  • Ensure your store’s email configuration is working
  • Check if the customer has exceeded the rate limit (5 codes per hour)

Customer Can’t Sign In

Symptoms: Verification code is rejected

Solutions:

  • Ensure the code hasn’t expired (10-minute window)
  • Check that the customer hasn’t exceeded 5 verification attempts
  • Have the customer request a new code

Symptoms: No sign-in link on the storefront

Solutions:

  • Verify customer accounts are enabled in Settings > General
  • Check that your theme supports customer account links

Navigation

Type to search…

↑↓ navigate↵ selectEsc close