Connect your FedEx account to show live FedEx rates at checkout and buy FedEx labels from your orders. Rates come from your own account, and labels are billed to it.
FedEx has to approve your labels before your production keys can buy real ones. Its review usually takes about three business days, so start early. See Getting Approved for Labels.
Features
| Feature | Description |
|---|---|
| Live rates at checkout | Your FedEx account rates for each package, on the services that package may use |
| Shipping labels | Buy, print and void FedEx labels from an order |
| Firearm rules built in | Handguns get air services only, ammunition gets FedEx Ground or Home Delivery, and firearm labels are bought with an adult signature |
Before You Start
You need:
- A FedEx account number
- FedEx’s approval to ship firearms on that account, under a FedEx Firearms Shipping Compliance Agreement, plus hazmat approval if you’ll ship ammunition. Ask your FedEx account executive.
- A project on the FedEx Developer Portal for your API keys
Creating Your API Keys
- Sign in to the FedEx Developer Portal with your fedex.com login
- Create an API project and add the Ship API and the Rates and Transit Times API to it
- Copy the project’s test API Key and Secret Key
Test keys only work with Enable Sandbox Mode turned on. You’ll use them to print the sample labels FedEx asks for.
Getting Approved for Labels
FedEx reviews sample labels before it lets your production keys buy real ones. Rates don’t need this review, so live rates at checkout work with your production keys straight away, but label purchases fail until FedEx approves your labels.
- Print sample labels. Activate the plugin with your test keys and Enable Sandbox Mode turned on. On an order, use Buy & print label to buy a label for each FedEx service you plan to use, such as FedEx Ground, FedEx Home Delivery, FedEx 2Day and FedEx Priority Overnight. Sandbox labels are free.
- Print and scan them. Print each label at actual size on your label printer, then scan it at 600 DPI or higher. FedEx wants scans of printed labels, not the label files. Scaling and print quality are the most common reasons FedEx rejects a label.
- Move your project to production. In the Developer Portal, move the project to production. FedEx shows your production API key and secret key. The secret key is shown only once, so save it. You can regenerate it later.
- Fill in the Label Cover Sheet from FedEx’s API certification page, with your contact details, account number, production API key and the services you’ll use.
- Email the cover sheet and your scans to label@fedex.com.
FedEx’s label team usually replies within three business days. If it rejects a label, fix what it flags and send it again. Once FedEx emails to confirm your approval, switch FirearmCart to your production keys.
Setting Up
- Go to Plugins > Marketplace and find FedEx
- Click Activate
- Enter your API Key, API Secret and Account Number
- Turn on Enable Sandbox Mode if you entered test keys
- Click Activate Plugin
FirearmCart checks your API key and secret with FedEx when you click Activate Plugin, and doesn’t save them if FedEx turns them down. The check doesn’t cover your account number, which FedEx only sees when you get rates or buy a label. Configure checks your keys the same way when you change them.
The first time you activate the plugin, its ship-from address is copied from your store address under Settings > General.
Switching to Production Keys
- On Plugins > Marketplace, click Configure on FedEx
- Enter your production API Key and API Secret
- Turn off Enable Sandbox Mode
- Click Save
Settings
Open Plugins > FedEx, make your changes and click Save settings.
| Setting | What it does |
|---|---|
| Show FedEx rates at checkout | Quotes live FedEx rates for any cart FedEx can ship, in place of your paid zone rates. Off by default. |
| Rate display at checkout | Combined shows one shipping price for the whole order, named for the services its packages use, such as FedEx 2Day + FedEx Ground for a handgun and ammunition. Per package shows a separate rate for each package that has to ship on its own. |
| Rate buffer | Adds a flat amount, a percentage, or both to each live rate. See Real-Time Rate Buffer. |
| I have an active FedEx Firearms Shipping Compliance Agreement | Confirms your FedEx account is approved to ship firearms. Until it’s on, FirearmCart won’t buy a FedEx label for a handgun or long gun, and leaves FedEx out of firearm rates when you buy a label. |
| Services shown at checkout | The FedEx services customers can choose from. All are selected by default. The rates you see when you buy a label follow this list too. |
| Max box weight (lb) | The heaviest box you ship, from 1 to 150 lb. A heavier order is split into several boxes, each with its own label. Leave it blank to use FedEx’s 150 lb limit. |
| Ship-from address | Where your packages ship from. FedEx can’t quote a rate until it has a ZIP code. |
Rate display at checkout, Rate buffer and Services shown at checkout appear once Show FedEx rates at checkout is on. Firearm and ammunition rules still win over your service choices: ammunition always keeps a ground service and handguns always keep an air service, even if you untick them.
Shipping explains how live rates sit alongside your zone rates at checkout. Keep a paid zone rate as a backup: checkout shows it when FedEx can’t quote, and without one customers can’t check out then.
What FedEx Can Ship
FirearmCart offers each item only the FedEx services it may use:
| Item | FedEx services |
|---|---|
| Handguns | First Overnight, Priority Overnight, Standard Overnight, 2Day A.M., 2Day |
| Long guns | Any service |
| Ammunition | FedEx Ground or FedEx Home Delivery |
| Accessories | Any service |
- Handguns. Your FedEx firearms agreement decides which air services your account may use for handguns. Untick any it doesn’t cover under Services shown at checkout.
- Ammunition. Ammunition ships in its own package and needs hazmat approval on your FedEx account. Hand ammunition packages to a scheduled pickup or a staffed FedEx Ship Center, never a FedEx Office or a drop box.
- Adult signature. Every handgun and long gun label is bought with FedEx Adult Signature Required, and live rates include it.
See Shipping Firearms for how a cart is split into packages.
Buying Labels
Buy labels from the order page: open the fulfillment’s menu and choose Buy & print label. FedEx labels open as 4x6 PDFs for your label printer. See Shipping Orders.
Troubleshooting
FedEx Authentication Failed
A message starting FedEx authentication failed means FedEx turned down your keys. It shows under API Key when you activate the plugin or save it with Configure, and on Plugins > FedEx after Test connection. Check that the key and secret come from the same project, and that Enable Sandbox Mode matches them: on for test keys, off for production keys.
FedEx Is Rejecting Your Credentials
If FedEx turns down your API key and secret at checkout or when you buy a label, Plugins > FedEx shows FedEx is rejecting your credentials, and everyone on your team gets the Tax or shipping connection rejected alert. See Notifications. Until it’s fixed, checkout shows your paid zone rates instead of live FedEx rates, and FedEx labels can’t be bought.
Click Configure on the FedEx card under Plugins > Marketplace and enter the key and secret again, then click Test connection on Plugins > FedEx. The warning clears as soon as FedEx accepts them.
Rates Work but Labels Fail
If live rates come back but buying a label fails with your production keys, FedEx most likely hasn’t approved your labels yet. Finish Getting Approved for Labels, or switch back to your test keys with Enable Sandbox Mode turned on while you wait.
No FedEx Rates When Buying a Firearm Label
Turn on I have an active FedEx Firearms Shipping Compliance Agreement on Plugins > FedEx and click Save settings. FedEx firearm rates and labels stay unavailable until it’s on.
No FedEx Rates at Checkout
- Show FedEx rates at checkout is off
- FedEx is rejecting your credentials
- The ship-from address has no ZIP code
- An item is heavier than your Max box weight, or 150 lb, and can’t be split across boxes
Related Documentation
- Shipping Orders - Buy, print and void labels
- Shipping Firearms - Carrier rules for each item type
- Shipping - Zone rates and the rate buffer
- UPS - UPS rates and labels
- Stamps.com - USPS rates and labels

