ShipStation Integration
Connect your FirearmCart store with ShipStation for multi-carrier shipping and label printing.
Features
| Feature | Description |
|---|---|
| Order push | Fulfillments sent to your ShipStation queue |
| Real-time rates | Compare rates across your ShipStation carriers at checkout |
| Labels | Buy labels in ShipStation, or on the order page with Buy & print label |
| Tracking sync | Tracking updates flow back to FirearmCart automatically |
Prerequisites
Before connecting, you need:
- Active ShipStation subscription
- Carrier accounts connected in ShipStation (UPS, FedEx, etc.)
- API key and secret from ShipStation
Getting API Credentials
- Log into ShipStation
- Go to Settings > Account > API Settings
- Generate new API Key
- Copy API Key and Secret
Setting Up
- Navigate to Plugins > Marketplace
- Find ShipStation
- Click Activate
- Enter your API Key and API Secret
- Pick your Store — FirearmCart lists the stores on your ShipStation account and selects it for you if you only have one
- Click Activate Plugin
Your credentials are verified against ShipStation before activation, and the tracking webhook is registered for you automatically — there is nothing to paste into ShipStation by hand. Once active, a ShipStation entry appears under Plugins in the sidebar.
Configuration Options
Configure these on Plugins > ShipStation:
| Setting | Description |
|---|---|
| Ship From Address | Address, apartment/suite, city, state, ZIP — used to calculate rates |
| Carriers | Which of your ShipStation carriers to use for real-time rates |
| Services | Which services from each carrier to offer at checkout |
| Enable real-time rates at checkout | Master switch for checkout rating through ShipStation |
| Rate buffer | A flat amount and/or percent added to every live ShipStation rate at checkout — see Real-Time Rate Buffer |
| Max box weight (lb) | Weight ceiling used when splitting an order across multiple boxes |
| Test Connection | Verify your API key and secret authenticate with ShipStation |
Only one ShipStation connection is allowed per store.
Order Push
Orders reach ShipStation per fulfillment, not automatically on every order:
- Customer places order in FirearmCart
- The order’s fulfillments are processed — automatically if you have fulfillment auto-processing turned on in Settings > Fulfillment, otherwise when you process them from the order page
- Each ShipStation-routed fulfillment is pushed into your ShipStation queue
- Create the shipping label in ShipStation
- Tracking syncs back to FirearmCart
- Customer receives shipping notification
What Gets Pushed
- Order number (order ID plus fulfillment ID)
- Customer email
- Bill-to address (always the customer)
- Ship-to address — the FFL for firearm fulfillments, otherwise the customer’s shipping address
- Line items: SKU, name, quantity, unit price, UPC
- Amount paid, shipping and tax
- The order note
Dropship lines are stripped before the push — only warehouse-shippable items are sent.
Order Status in ShipStation
A paid order arrives under Awaiting Shipment. An order with a partial refund arrives On Hold, so you can check what to send, because its items may still include what was refunded. The exception is a refund made with Change Quantity, which takes the refunded units off the order: when every refund on an order came from it, the order arrives under Awaiting Shipment.
Return to Needs Processing removes a fulfillment’s order from ShipStation. When you process the fulfillment again, ShipStation gets a new order with the same order number.
Real-Time Rates
With Enable real-time rates at checkout on, ShipStation returns live rates at checkout:
- Rates come from the carriers and services you selected
- Rated against your Ship From address and the customer’s destination
- Options that aren’t legal for the shipment’s item class (for example, handguns) are filtered out before the customer sees them
- Handguns are quoted only on the air services you select: UPS Next Day Air or 2nd Day Air, and FedEx overnight or 2Day. Your carrier’s firearms agreement must cover the service. With none selected, handgun orders get your zone rates
- Ammunition is quoted only on UPS Ground and FedEx Ground or Home Delivery. UPS Ground Saver and FedEx Ground Economy are never offered for it: both can hand the package to USPS, which won’t carry ammunition
- Long guns can use any service you select except UPS Ground Saver and FedEx Ground Economy, which collect no signature, and firearm labels need an adult signature
- Firearm rates include the adult signature the label is bought with
- An order that has to ship as separate packages gets one price. When the packages use different services, the option is named for them, such as UPS 2nd Day Air + UPS Ground Saver for a handgun and a magazine, and the order page shows the same name next to Customer selected
- Any Rate buffer you set is added to each rate; customers only see the final price
- The customer’s selected rate is applied to the order
If ShipStation can’t quote (it’s slow to answer, returns an error, or none of your selected services comes back), checkout shows your paid zone rates instead. Keep a paid rate in one of your own zones, or customers can’t check out until ShipStation answers again. See Keep a Backup Rate for Real-Time Rates. Checkout skips the ShipStation Real-Time Rates zone created at activation.
FFL Shipping
For firearm orders:
- The FFL’s address is used as the ship-to on the fulfillment pushed to ShipStation, with the FFL’s business name as the company
- The customer remains the bill-to
- When a label is purchased through ShipStation rating rather than in the ShipStation UI, adult signature is set automatically for handgun and long-gun shipments
Tracking Sync
Tracking flows back two ways, and the two are de-duplicated by tracking number:
- Webhook — ShipStation’s
SHIP_NOTIFYnotification, registered automatically at activation with a per-store secret - Polling — every 10 minutes FirearmCart also queries ShipStation for shipments on any fulfillment still awaiting tracking, because
SHIP_NOTIFYis delivered best-effort and can be delayed or dropped
When tracking arrives the fulfillment is marked shipped and the customer notification fires. With Enhanced Shipment Tracking, the tracking number is also followed for live status updates.
Troubleshooting
Orders Not Reaching ShipStation
- Use Test Connection on the ShipStation page to confirm the API credentials still authenticate
- Confirm the fulfillment is actually routed to ShipStation
- Confirm the fulfillment has warehouse-shippable items — dropship-only fulfillments are never pushed
- Check that the fulfillment was processed (automatically or from the order page)
Tracking Not Updating
- Give the 10-minute polling sweep a chance to run — it picks up shipments the webhook missed
- Use Test Connection to confirm the API connection
- If the webhook registration failed at activation, deactivate and re-activate the plugin to re-register it
- Enter tracking manually on the fulfillment if needed
A Label Purchase Fails
When Buy & print label can’t buy a ShipStation label, the Label purchase failed message gives ShipStation’s reason.
If it asks you to accept the updated ShipStation Terms and Conditions, log into ShipStation and accept them, then buy the label again. ShipStation turns down every label until you do, even though its rates still appear.
Related Documentation
- Integrations Overview - All integrations
- Fulfillment - Order fulfillment
- Shipping Orders - Buy and print labels from an order
- Shipping - Shipping configuration
- Shipping Firearms - Firearm shipping requirements

