How to Connect Orchid eBound to Firearm Cart
Connect your Orchid eBound™ bound book to your Firearm Cart store so firearms import straight from your book, online stock follows counter sales, each paid order reserves a serial number, and the FFL transfer is recorded when the firearm ships. You need a company admin login to eBound, admin access to Firearm Cart, and one eBound API key for each bound book you connect.
Steps
- Get your eBound API key. In eBound, go to e-A&D → Create / Modify FFL and Bound Book. On the bound book you want to connect, click Modify → API Keys & Webhooks, then Generate API Key (or Copy if a key already exists). Each bound book has its own key. If you want to test first, submit a support ticket and ask for a sandbox key.
- Turn off FastBound if it is connected. Firearm Cart connects one electronic bound book at a time, so deactivate the FastBound plugin before you continue.
- Open the Firearm Cart Marketplace. In Firearm Cart, go to Plugins → Marketplace and click Activate on the Orchid eBound card.
- Paste the API key. Paste the key from step 1. Tick Enable Sandbox Mode only if it is a sandbox key; a production key works only with the box unticked.
- Click Activate. Firearm Cart checks the key against eBound before saving it. Orchid eBound then appears in the sidebar under Plugins and the first bound-book download starts.
- Review the settings. Open Plugins → Orchid eBound and check the settings in the table below. Stock sync and serial reservations are on by default.
- Import your firearms. On the plugin page, select the units to import and click Import. Units that share a UPC become one product; a used unit is always its own product. Products with no price or an unrecognized firearm type import as drafts. eBound records have no photos or descriptions, so add those before you publish.
Expected Result
- Orchid eBound shows under Plugins in the Firearm Cart sidebar (with a Sandbox badge if you used a sandbox key).
- Open units in your bound book appear on the plugin page, and imported products have stock that refreshes every 15 minutes.
- When an online order is paid, the oldest matching serial is reserved in eBound and shown as an eBound badge on the order.
Firearm Cart Settings for eBound
| Setting | Default | What it does |
|---|---|---|
| Orchid eBound enabled | On | Master switch for syncing, stock updates, reservations and transfers |
| Keep imported products’ stock in sync | On | Stock = open units not reserved or on a 4473, minus units on unshipped orders. Refreshes every 15 minutes |
| Reserve serials for paid orders | On | Reserves the oldest matching unit (first in, first out) in eBound so it is not sold at the counter |
| Record the FFL transfer when tracking is sent | Off | Records the disposition to the buyer’s FFL in eBound when the shipment gets a tracking number |
| Log API activity | Off | Keeps eBound API calls in the API Activity panel for troubleshooting |
Troubleshooting
| Problem | What to do |
|---|---|
| “Orchid eBound rejected your API key” | Check the key and the Enable Sandbox Mode box under Plugins → Orchid eBound → Configure, then click Retry sync. If you regenerated the key in eBound, paste the new one. |
| A sync shows “Downloaded X of Y units” | eBound did not return the whole book. Stock was not changed; the next sync retries. |
| An order says it needs a serial | No open, unreserved unit matches the product. Acquire it in eBound, or assign a serial from the order page. |
| A transfer was rejected | Open the order’s eBound badge to see the reason, fix the serial or FFL, then click Record transfer again. |
Related Articles
- → Firearm Cart documentation: Orchid eBound
- → How to Connect Orchid eState to Firearm Cart
- → How to Connect Orchid eBound to ATF FFL Direct
- → How to Connect Orchid eBound to Master FFL (Online Sales)
- → Orchid eBound™ API Documentation
💡 Tip
Regenerating an API key in eBound stops the old key at once. If you regenerate it, paste the new key in Firearm Cart under Plugins → Orchid eBound → Configure right away. Switching between sandbox and production connects a different book, so Firearm Cart clears and re-downloads the units.
⚠ Compliance
Bound-book entries are final, so confirm the serial numbers on an order are the units in the box before the transfer is recorded. Firearm Cart never reserves or transfers NFA items (they go through ATF Form 3 or Form 4), and pickup orders have no transfer FFL: record those dispositions and the counter Form 4473 in eBound as usual. Questions? Submit a support ticket and Orchid’s compliance team will help.