Skip to content

Orchid eState

Check each order against the law at the customer's ZIP code, with Orchid eState's answer for every item's UPC

Updated View as Markdown

Orchid eState checks the items in an order against the law where the customer lives. At checkout, FirearmCart looks up each item’s UPC with Orchid for the customer’s ZIP code. Orchid’s answer takes precedence over your FFL Rules, which work state by state, so city and county rules are covered too.

What Orchid eState checks

Orchid answers in two ways, depending on the item.

Item What Orchid says
Firearms, suppressors, magazines, parts and accessories Whether the item is unrestricted, restricted, or must be on the state’s roster
Ammunition Whether it’s restricted, where it may ship (to the customer, to an FFL, or to the customer once a license, permit or age is checked), and the buyer’s minimum age

Items Orchid can’t check

Some items have no UPC, and Orchid doesn’t know every UPC. Those items use your FFL Rules at checkout, exactly as they would without the plugin. So do all items while Orchid can’t be reached.

Whatever Orchid says:

  • Your Blocked states and Category exclusions by state in FFL Rules still apply. They’re your store’s choices, and Orchid can’t lift them.
  • Product types in Always require FFL transfer still ship to an FFL.

Catalog coverage on the plugin page shows how many of your active products have a UPC that checkout can ask Orchid about.

Setting up Orchid eState

  1. Go to Plugins → Marketplace and click Activate on Orchid eState.
  2. Paste the API Key Orchid gave you.
  3. Click Activate. FirearmCart checks the key with a test lookup before saving it.
  4. Open Plugins → Orchid eState and review the Checkout rules.

To change the API key, click Configure on the Orchid eState card under Plugins → Marketplace.

Checkout rules

On Plugins → Orchid eState, under Checkout rules, you choose what checkout does with each kind of answer. Click Save Settings to apply your changes. Checkout uses them from the next order.

Setting Options Default
Check checkout with Orchid eState On, or off to use your FFL Rules alone On
When Orchid and your FFL Rules disagree Orchid decides: Orchid’s answer replaces your FFL Rules’ state checks for the items it knows. The stricter one wins: both apply, so Orchid can only add restrictions. Orchid decides
Roster State answers Customer confirms: the customer ticks a box confirming the firearm is on their state’s roster. Block the item. Allow the item: the receiving dealer checks the roster at transfer. Customer confirms
Ammunition that needs a license, permit or age check Ship once you’ve verified: the item ships to the customer after you check their document. Send to an FFL. Block the item. Ship once you’ve verified
Ammunition age rules Customer confirms their age: a required checkbox listing the age rules for their ZIP. Ask for date of birth: buyers under the minimum age can’t order the item. Show on the order only: no step at checkout. Customer confirms their age
If Orchid can’t be reached Use your FFL Rules. Use your FFL Rules and hold the order: the items Orchid would have checked wait in Needs Processing for you to review. Use your FFL Rules
Also check the dealer’s ZIP for items that ship to an FFL When on, an item restricted where the selected dealer is asks the customer to choose another dealer Off
Log API calls Keeps each lookup’s request and response under Activity. The API key is never shown. Off

Orchid’s federal age baseline (18 for rifle and shotgun ammunition, 21 for handgun ammunition) applies in most ZIPs, so with Customer confirms their age, nearly every ammunition order shows the age checkbox.

What customers see at checkout

When the customer enters their shipping ZIP, checkout looks their items up and shows, above Pay Now:

  • Items that can’t ship to their ZIP, with the reason. They can’t pay until they remove them or change the address.
  • A roster checkbox, for firearms Orchid answers Roster State for.
  • The age rules for their ZIP, with a checkbox or a date of birth field, depending on your setting.
  • A note on items that ship once you’ve checked a license, permit or photo ID.

Items that must go through a dealer turn on the FFL step, as firearms do. Checkout checks everything again when the customer clicks Pay Now.

Items that need a license, permit or age check

For some ZIPs, Orchid allows ammunition to ship to the customer only after the store checks a document. Examples are a FOID card in Illinois, a permit in New Jersey, or a photo ID for an age check in Hawaii. With Ship once you’ve verified:

  1. After ordering, the customer sees Upload your license or permit (or photo ID) on the order confirmation and on their order page. A customer who already has a driver’s license or state ID on file, uploaded from their account or by you on their customer page, isn’t asked for a photo ID again. A file that isn’t an ID or license at all, such as a random photo, is turned away. A different ID or license, such as a driver’s license, is kept and flagged for you to check (see Automatic Check on Customer Uploads).
  2. The item waits under Needs Processing, with the reason on its timeline, and you get one alert for the order.
  3. Open the order, check the uploaded document (click the customer’s files on Order Details), and click Process Fulfillments.
  4. In the confirmation, tick I’ve checked these and click Confirm & Process. FirearmCart records who checked it. Leave the box unticked to send the rest of the order and keep these items waiting.

AI apps connected to your store can’t send these items. Only a person on the order page can confirm the check.

How Orchid’s answers become checkout decisions

Firearms, suppressors, magazines, parts and accessories

Orchid’s answer At checkout
1 Unrestricted Allowed. It ships to an FFL if its product type requires one, under Always require FFL transfer or the state’s FFL categories.
2 Restricted Blocked for that ZIP
3 Roster State Follows Roster State answers
5 UPC not found Your FFL Rules decide

Ammunition

Orchid’s answer At checkout
A Restricted, FF Restricted, or age FFF Blocked for that ZIP
AA Ship to consumer Ships to the customer
CC Ship to FFL or dealer Ships to an FFL
BB, SNJ (except shotgun ammunition), SHI Follows Ammunition that needs a license, permit or age check
SCO Ships to the customer with Adult Signature on a service that confirms the recipient’s age
Age rules (AAA, BBB, ACOCF, ACORF, ADE, AMD, ANJ) Follow Ammunition age rules
5 UPC not found Your FFL Rules decide

If Orchid returns a code FirearmCart doesn’t recognise, your FFL Rules decide the item and it waits in Needs Processing for you to review.

The Compliance card on an order

Each order checked with Orchid eState shows a Compliance card on Order Details. It lists the ZIP checked, each item’s answer, whether it ships to an FFL, and what the customer confirmed. It also shows anything still waiting on you.

  • Re-check with Orchid looks up the items that haven’t shipped yet at the order’s current shipping address. Use it for orders you created yourself or that came from a marketplace.
  • When you change an order’s shipping address, the items that haven’t shipped are looked up again at the new ZIP. An item restricted at the new address waits in Needs Processing until you change the address or cancel it.

Orders already placed keep the routing checkout decided for them, even if you later change your settings or turn the plugin off.

Labels for ammunition that needs an adult signature

When Orchid answers SCO, the label must use a service that confirms the recipient’s age and requires a signature. Buying a label for that item on the order page or the Fulfillments page locks Require adult signature on delivery on. A distributor drop ship of that item waits in Needs Processing, because the distributor picks the carrier service. Make sure it ships that way, or ship it yourself.

If Orchid can’t be reached

Checkout never waits on Orchid for long. If Orchid doesn’t answer, your FFL Rules decide the items it would have checked. With Use your FFL Rules and hold the order, those items also wait in Needs Processing for you to review.

If Orchid turns down your API key, a warning shows on the plugin page and you get one alert. Checkout uses your FFL Rules until you update the key.

Look up an item

Under Look up an item on the plugin page, enter a UPC and a ZIP, and optionally a State, then click Look up. FirearmCart asks Orchid, then shows its answer and what checkout would do with it under your current rules. Orchid’s test ZIP is 21205, with test UPCs 090161045156 (unrestricted), 845737002367 (restricted), 022188865813 (roster state) and 123412341234 (not found).

Navigation

Type to search…

↑↓ navigate↵ selectEsc close