All Collections
FedEx Shipping Setup
FedEx Shipping Setup

Learn how to configure the FedEx shipping method in your store.

Olga Tereshina avatar
Written by Olga Tereshina
Updated over a week ago

The add-on FedEx for X-Cart 5 allows you to use online shipping rate calculation via FedEx service.

To start using FedEx shipping facilities in your store, you need to have the FedEx Shipping add-on installed and configured. General guides on the add-on installation you can find here.

Enabling FedEx Shipping

To enable the FedEx shipping method in your store:

  1. In the Shipping section of your X-Cart store's Admin area (Store setup > Shipping), click the Add shipping method button:

  2. In the popup that appears, choose the FedEx shipping method:


    Then, the DHL settings page will open.

  3. Configure FedEx general settings using your FedEx account information.

    Provide your credentials for API access:

    • FedEx authentication key: Specify your authentication key.

    • FedEx authentication password Specify your password.

      NOTE: Your production credentials (FedEx authentication key and FedEx authentication password) can be obtained from FedEx Developer Resource Center at Please contact FedEx Online Support for assistance with getting your production credentials for FedEx Web Services.

    • FedEx account number: Specify your FedEx account number.

    • FedEx meter number: Specify your FedEx meter number. A FedEx Meter Number is an identification number that FedEx will use to pull your negotiated rates.

    • Test mode: Enable the toggle to test your store's FedEx integration before going into production. You will also need to use your test credentials to access the API for testing.

      NOTE: When you decide to switch your store's FedEx integration to production mode, you will need to replace the test credentials with the production ones. You will be able to obtain your production credentials after selecting Move to Production in your FedEx account.

    • Enable debugging: Enable this toggle if you want to log the requests sent to the FedEx services by the store and the responses received from FedEx by the store.
      The logs will be saved to fedex.log files in the <X-Cart>/var/log/ folder.

  4. In the Carrier types section, specify the preferred FedEx configuration:


    • FedEx Express (FDXE): Enable FedEx Express if you want to use this service.

    • FedEx Ground (FDXG): Enable FedEx Ground if you want to use this service. FedEx Ground delivers in 1–7 business days, based on the distance to the destination.

    • FedEx SmartPost (FXSP): Enable FedEx SmartPost if you want to use this service. FXSP picks up (or accepts drop shipments), provides line haul, and delivers your packages to a USPS facility for final delivery by a postal carrier. If FedEx SmartPost is enabled, the following two settings will also become available.


      Be sure to enable the following settings:

      • Hub ID: Select your Hub ID.

      • Indicia: Specify the indicia type.

    • Rate request type: Select the type of rates that your store should use for shipments.

    • Packaging: Select the type of packaging for your shipments.

    • Dropoff type: Select the type of dropoff that the store should use for shipments.

    • Ship date (days): Set the number of days until the order is shipped.

    • Currency code: If the shipping currency is other than USD, specify it in this field.

    • Currency rate: If the currency code specified above differs from the currency the store uses for payments, set a conversion rate to convert the shipping cost returned by FedEx into your store's currency. If the currencies are the same, set the value 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.

  5. If you are going to use special services, configure them in the Special services section:


    Note that special services may imply extra fees.

  6. The section Cash on delivery shows the status of your cash-on-delivery option for FedEx shipments.


    Note that you may not change this status directly from the FedEx add-on setting page.

    To change the status, you will need to go to the Payment Settings page of your store's Admi Area (Store Setup -> Payment Methods) or either follow the link in the help note:


    Important: Cash-on-delivery method of payment is not available for all FedEx services. Before enabling FedEx COD for your customers, you should contact FedEx to determine which services support COD.

    On the Payment Settings page, you will find the setting to toggle the cash-on-delivery option for FedEx next to the name of your FedEx method in the Offline methods list:


    The FedEx add-on settings page will adjust the setting accordingly. (You may have to refresh the add-on settings page to see the current status correctly. But be sure to save any unsaved add-on settings before refreshing the page.)

    After activating the cash-on-delivery option for FedEx, X-Cart will add another field in the Cash-on-delivery section of the FedEx add-on settings page: COD type.


    Use this field to select the funds FedEx should collect upon package delivery.

  7. Adjust the settings in the Advanced options section as you require.

    Not all FedEx Carrier Services support the advanced options, so please consult FedEx support before using them.


    Note that advanced options may affect the shipping rates calculation and may imply extra fees.

  8. Click the Submit button at the bottom of the page to save the FedEx configuration.

Configuring FedEx Carrier Services

Once you save the basic FedEx configuration settings, the tab Carrier Services will become available on the FedEx add-on settings page.

Proceed to the Carrier Services tab to specify the FedEx carrier services available for shipment. The carrier services you select here will be available to your customers at checkout if the conditions from the FedEx Settings tab are met.


On the Carrier Services tab, you can enable/disable FedEx carrier services, change the services sort order, and apply tax classes to shipments, if applicable.


By default, carrier services are sorted alphabetically. However, you can drag-n-drop the carrier services to re-adjust their positions if you want to reorder them. The checkout page will reflect the sorting set on the Carrier Services tab.

Related pages:

Did this answer your question?