---
title: "FedEx"
description: "Show live FedEx rates at checkout and buy FedEx labels from your orders with your own FedEx account, including the label approval FedEx requires before you can buy real labels"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.firearmcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FedEx

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](#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](https://developer.fedex.com) for your API keys

### Creating Your API Keys

1. Sign in to the [FedEx Developer Portal](https://developer.fedex.com) with your fedex.com login
2. Create an API project and add the **Ship API** and the **Rates and Transit Times API** to it
3. 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.

1. **Print sample labels.** [Activate the plugin](#setting-up) 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.
2. **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.
3. **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.
4. **Fill in the Label Cover Sheet** from FedEx's [API certification page](https://developer.fedex.com/api/en-us/project/certification.html), with your contact details, account number, production API key and the services you'll use.
5. **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

1. Go to **Plugins > Marketplace** and find **FedEx**
2. Click **Activate**
3. Enter your **API Key**, **API Secret** and **Account Number**
4. Turn on **Enable Sandbox Mode** if you entered test keys
5. 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

1. On **Plugins > Marketplace**, click **Configure** on FedEx
2. Enter your production **API Key** and **API Secret**
3. Turn off **Enable Sandbox Mode**
4. 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](/store-setup/shipping#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](/store-setup/shipping) explains how live rates sit alongside your zone rates at checkout. Keep a paid zone rate as a [backup](/store-setup/shipping#keep-a-backup-rate-for-real-time-rates): 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](/ffl-compliance/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](/orders/shipping).

---

## 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](/account/notifications). Until it's fixed, checkout shows your paid [zone rates](/store-setup/shipping) 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](#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](#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](/orders/shipping) - Buy, print and void labels
- [Shipping Firearms](/ffl-compliance/shipping-firearms) - Carrier rules for each item type
- [Shipping](/store-setup/shipping) - Zone rates and the rate buffer
- [UPS](/integrations/ups) - UPS rates and labels
- [Stamps.com](/integrations/stamps-com) - USPS rates and labels

Source: https://docs.firearmcart.com/integrations/fedex/index.mdx
