⚠️ Requires X-Cart 5.0.0.x or later. |
Table of Contents |
What is FedEx?
FedEx is a global delivery company. The FedEx add-on connects your store to their services, offering customers multiple shipping options at checkout, with varying costs and delivery times. It automatically calculates rates based on the cart’s contents and dimensions, making it easy for customers to choose shipping option.
This add-on works via FedEx Web Services API.
Before You Start
Create a FedEx Account to get your test and production API credentials (What's this?).
Adding FedEx as a Shipping Method
To enable FedEx as a shipping option on your store’s checkout page from your X-Cart Admin, you need to add it as a Shipping Method in your X-Cart Admin. To do that:
Go to Store › Shipping.
Open the Methods tab and click Add New.
In the popup, go to the Carrier Accounts tab, find FedEx, and click Add.
After adding, you’ll be taken to the FedEx Settings page, where you can start setting it up by connecting your FedEx account.
Connecting Your FedEx Account
Now, let’s link your store to FedEx Web Services. This will add FedEx delivery options to your X-Cart admin and enable automatic rate calculation at checkout. We’ll cover how to manage these options later in the guide.
To connect your FedEx account:
Go to Store › Shipping.
Open the Methods tab.
Under Calculated Shipping Rates find FedEx and click Settings to open FedEx Settings page.
On the settings page, complete the three fields at the top with your FedEx account credentials:
FedEx API key | This 36-character code lets X-Cart connect to FedEx Web Services. Make sure the Key you choose to use is of correct type based on your setup. |
FedEx API secret | A 32-character code that works with your API Key to secure and verify requests. You’ll need both for the connection to work properly. |
FedEx account number | Your unique 9-digit customer number. Learn how to find your account number. |
Types of API Credentials
FedEx API key and FedEx API secret come in two types: production and testing.
Production Credentials
Production Credentials
These credentials are used for handling real orders. You can obtain them from the FedEx Developer Resource Center or by contacting FedEx Online Support.
Testing Credentials
Testing Credentials
These credentials let you simulate FedEx services, like the rate calculator, to check your setup for issues without creating real shipments or incurring charges. To use testing credentials, make sure Test Mode is enabled.
To obtain them:
Log in to your FedEx Web Services account.
Go to Develop and Test, then click
Get Your Test Key
.
If you're unsure about any of these, check your FedEx account settings or contact FedEx support for assistance.
⚠️ Do not use test credentials for real shipping!
When you’re ready to go live, replace your test credentials with production ones. You can get these by selecting Move to Production in your FedEx account.
Using Test Mode (Optional)
Below the credentials fields, you'll find a Test Mode toggle. Turn it on to test your store's FedEx integration before switching to production.
Use the test credentials from the section above 👆🏻 for this mode to work.
Debugging mode (Optional)
Below the Test Mode toggle, you'll find the Enable Debugging toggle.
Turn it on to log the data sent to FedEx and the responses returned to X-Cart.
Remember, to disable the toggle when you're done logging to prevent website performance issues.
👾 These logs are saved as fedex.log files in the <X-Cart>/var/log/
folder and can help our support team to identify and fix errors in your store.
Completing the Connection
After adding your FedEx credentials, click Submit to finalize the connection.
FedEx Settings
Once your FedEx account is connected to X-Cart, you can select Shipping Options and setup other settings.
Choosing FedEx Shipping Option
To select preferred delivery options you want to offer for your customers:
Go to Store › Shipping in your X-Cart admin panel.
Under Methods, find FedEx and click Settings.
On the next page, scroll to the Carrier Types section.
Click the arrow to expand.
You’ll see three toggle options for FedEx shipping methods, each with different delivery speeds and features.
Service Type | Delivery Details | Key Features |
FedEx Express (FDXE) | 1–3 business days in the U.S. for items up to 150 lbs.
| Fastest delivery with a money-back guarantee, including free packaging.
|
FedEx Ground (FDXG) | 1-7 business days in the U.S. (3-7 days for Alaska and Hawaii)
2-7 business days to Canada. | Ideal for standard delivery, for less time-sensitive shipments.
|
FedEx SmartPost (FXSP) *Now called Ground® Economy | In 2–7 business days (longer for Alaska and Hawaii) for packages up to 70 lbs | - Most affordable option for lightweight items.
- FedEx handles pickup and transportation, USPS completes the delivery.
- No money-back guarantees or address changes.
|
It's not necessary to select all of them, as too many choices may overwhelm your customers. Select the ones that best suit your needs, considering factors like cost, delivery speed, item size, and customer preferences.
FedEx Basic Settings
After selecting your preferred options, you need to adjust several settings:
💾 Remember to click Save Changes, when you're done.
FedEx SmartPost Settings
If you enabled FedEx SmartPost (FXSP) , you'll need also to provide the following:
Hub ID
Hub ID
A code that identifies the nearest FedEx SmartPost hub to your account. Ask FedEx support to provide it.
Indicia
Indicia
Defines the type of shipment (size, weight) that will be shipped:
MEDIA_MAIL
– books, docs etc.PARCEL_SELECT
– packages weighing between 1 and 70 poundsPresorted Bound Printed Matter
– packages containing permanently bound sheets, such as books or catalogs.PRESORTED_STANDARD
– mail and items less than 1 pound.Parcel Return
– shipments that are return packages.
Rate request type
The FedEx Add-on automatically calculates shipping rates based on weight, size, origin, and destination, and displays the result to customers at checkout.
The Rate Request Type selector lets you choose how automatic shipping rates are calculated and shown to your customers at checkout.
There are three options:
| Rates are calculated using standard FedEx pricing. |
| Rates are based on discounted pricing associated with your account. Getting these rates may require shipping high volumes, using FedEx for all deliveries, or joining their rewards program. Contact your FedEx representative to negotiate. |
| Rates are calculated using standard FedEx pricing but are converted in the currency specified in the Currency Code section, making international shipments more convenient. |
Packaging
Use Packaging selector to choose the type of packaging for your deliveries. By default, the packaging is set to My Packaging , meaning you can use your own boxes within the following limits:
FedEx Express (FDXE): Up to 150 lbs / 68 KG
FedEx Ground (FDXG): Up to 70 lbs / 32 KG
FedEx SmartPost (FXSP): Up to 70 lbs / 32 KG
📦 Use sturdy boxes that are free from crushing or any damage.
If you’re shipping with FedEx Express (FDXE) , you can select from free custom packaging options:
| up to 1 lb / 0.5 KG |
| up to 20 lbs / 9 KG |
| up to 20 lbs / 9 KG |
| up to 22 lbs / 10 KG |
| up to 55 lbs / 25 KG |
These custom packaging options are not available for FedEx Ground (FDXG) or FedEx SmartPost (FXSP).
Ship date (days)
Set the number of days you need to prepare a parcel from when an order is placed until it’s ready for FedEx to pick up and ship.
Currency code
If the shipping currency is other than USD, specify it in this selector.
Currency rate
If your store's currency differs from the one specified, set a conversion rate to adjust FedEx's shipping costs. If the currencies are the same, just set the rate to 1.
Package dimensions (inches):
Use these fields to define the default package size used for FedEx shipments (Length, Width, Height in inches).
Maximum package weight
Specify the maximum package weight limit you plan to send. Use this specifications for your reference.
Special Services
Below the Carrier Type(s), you'll find the FedEx Settings section. Click the arrowto expand it.
Here, you'll find two settings Signature option and FedEx One Rate. Both of these services may imply extra fees.
Choosing Signature Option for Handover Confirmation
Requiring a signature upon delivery helps protect both you and your customers from financial loss. It ensures the product reaches the right person, and if someone else signs for it and the package is stolen, FedEx may cover the loss.
💡 For high-value items, requiring a signature is a smart choice, while lower-value items can be left at the door for added convenience.
To set a preferred signature type for all FedEx shipping methods:
Go to Store › Shipping.
Open the Methods tab.
Under Calculated Shipping Rates, find FedEx and click Settings to open the FedEx Settings page.
Under Special Services, click the Signature Option selector.
There are several signature types varying by levels of security:
Signature type | Description |
Service Default | FedEx may try to get a signature, but it’s not guaranteed. |
No signature required | If customer is not is available, package will be left in a safe place on site. |
Indirect Signature Required | Anyone near the address can sign, or the customer can choose to allow delivery without a signature using FedEx Delivery Manager. |
Direct Signature Required | Someone at the address must sign. If no one is available, FedEx will attempt delivery on another date. |
Adult Signature Required | A person at the address, 21 or older with a valid photo ID, must sign. If no one is available, FedEx will attempt delivery on another date. |
💾 When you're done selecting, click Submit.
Activating FedEx One Rate ® (Flat-rate shipping option)
FedEx One Rate is a flat-rate delivery option for domestic U.S. shipments with a simple pricing based on 12 predefined package sizes instead of weight. Learn more about this service, delivery speeds, and packaging options here.
Enable the FedEx One Rate toggle, then click Submit 💾 to make this option available at checkout.
Cash on Delivery
FedEx Cash on Delivery (COD) lets customers pay for products upon arrival, instead of paying upfront on your website. The courier collects the payment and transfers it to you.
⚠️ Cash on Delivery is only available for selected delivery methods.
To enable this option:
On the next page, scroll to the Cash On Deliver section.
Click the arrow to expand.
Click on the Payment methods page link below "Cash on delivery" status toggle.
OR: Go to Store › Payment Methods.
On the next page, scroll to the bottom and find Offline section, under it enable Cash on Delivery (FedEx) toggle.
After that, return to the Cash On Delivery section in FedEx settings and use COD type selector to choose between these options:
Any Funds | Any payment method can be used: cash, check, or money order etc. |
Guaranteed Funds | Payment must be made with a certified check or money order, ensuring that the payment is secure. |
Cash | Recipient must pay in cash, and FedEx will send the payment to you by check the next business day. |
💾 After selecting your COD type, click Submit to save.
Advanced Options
In this section you can customize pickup handling and insurance options. Not all FedEx delivery methods support these features, and enabling them might come with additional fees. Contact FedEx support before making any changes here.
Shipment is scheduled for Saturday pickup
FedEx usually picks up parcels Monday to Friday. Enable the Shipment is scheduled for Saturday pickup toggle to allow shipping on Saturdays when possible. Urgent deliveries can give your business a competitive edge, though they come at a premium.
Shipment from residential address
Enable Shipment from residential address toggle if you're shipping from home to hide delivery options that don’t offer pick-up from non-commercial areas.
Send package cost to calculate insurance
Enable the Send package cost to calculate insurance toggle if you sell valuable items. This lets FedEx automatically calculate insurance based on the declared value, ensuring your package is covered in case of loss or damage.
💾 After enabling or disabling any options, click Submit.
Selecting FedEx Services to Display at Checkout
After saving the basic FedEx settings, go to the Carrier Services tab to select delivery options for shipments.
To show or hide a delivery option, click the on/off button next to the carrier service name. The enabled options will appear at checkout for your customers, as long as the conditions from the FedEx Settings tab are met.
💾 When you're done, click Save Changes.
Showing / Hiding All FedEx Services at Checkout
To make FedEx visible as a shipping option at checkout:
Go to Store › Shipping.
Open the Methods tab.
Under Calculated Shipping Rates find FedEx and click Settings to open FedEx Settings page.
Enable This shipping carrier is toggle, under the FedEx Settings or Carrier Services tabs.
💾 Your changes will be saved automatically.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!