How to Connect Orchid eState to Firearm Cart
Connect Orchid eState™ to your Firearm Cart store so checkout checks every item against the law at the customer’s ZIP code, including city and county rules, using each item’s UPC. Each store uses its own eState API key, issued by Orchid. You need an active eState subscription and admin access to Firearm Cart.
Steps
- Request your eState API key. Submit a support ticket asking for an eState API key for your Firearm Cart store. The key is unique to your store; do not share it or use another store’s key.
- Open the Firearm Cart Marketplace. In Firearm Cart, go to Plugins → Marketplace and click Activate on the Orchid eState card.
- Paste the API key. Paste the key Orchid sent you.
- Click Activate. Firearm Cart checks the key with a test lookup before saving it. Orchid eState then appears in the sidebar under Plugins.
- Review the checkout rules. Open Plugins → Orchid eState, review the Checkout rules in the table below, and click Save Settings. Checkout uses them from the next order.
- Test a lookup. Under Look up an item, enter a UPC and ZIP and click Look up. Orchid’s test ZIP is 21205, with test UPCs 090161045156 (unrestricted), 845737002367 (restricted), 022188865813 (roster state) and 123412341234 (not found).
Expected Result
- Orchid eState shows under Plugins in the Firearm Cart sidebar, and the test lookup returns an answer.
- Catalog coverage on the plugin page shows how many active products have a UPC that checkout can check.
- At checkout, items that cannot ship to the customer’s ZIP are flagged with the reason before the customer can pay.
Checkout Rules
| 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, or the stricter one wins | Orchid decides |
| Roster State answers | Customer confirms, block the item, or allow it (dealer checks the roster at transfer) | Customer confirms |
| Ammunition that needs a license, permit or age check | Ship once you’ve verified, send to an FFL, or block | Ship once you’ve verified |
| Ammunition age rules | Customer confirms age, ask for date of birth, or show on the order only | Customer confirms age |
| If Orchid can’t be reached | Use your FFL Rules, or use them and hold the order for review | Use your FFL Rules |
| Also check the dealer’s ZIP for items that ship to an FFL | On or off | Off |
| Log API calls | On or off (the API key is never shown) | Off |
Items with no UPC, or a UPC eState does not know, fall back to your Firearm Cart FFL Rules. Your blocked states, category exclusions by state and Always require FFL transfer product types still apply whatever eState answers.
Related Articles
- → Firearm Cart documentation: Orchid eState
- → How to Connect Orchid eBound to Firearm Cart
- → Orchid eState API Documentation
- → Section 1: Estate Getting Started
💡 Tip
Each order checked with eState shows a Compliance card on Order Details. Use Re-check with Orchid for orders you create yourself or that come from a marketplace, and after changing a shipping address.
⚠ Compliance
eState answers are a compliance aid, not legal advice, and you remain responsible for each sale. Ammunition that ships only after a license, permit or ID check waits in Needs Processing until a person on your team checks the document and confirms it. Questions about a state or local rule? Submit a support ticket and Orchid’s compliance team will help.