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 FedEx shipping 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:


    You will be redirected to the DHL settings page.

  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.

    • 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: If you need to test your store’s FedEx integration before going into production, enable the toggle.
      For testing, you will also need to use your test credentials for access to the API.

      When you decide to switch your store’s FedEx integration to the 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 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 that should be used for your shipments.

    • Dropoff type: Select the type of drop-off 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, specify a conversion rate to convert the shipping cost returned by FedEx into your store’s currency. If the currencies are the same, leave this set 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 section Special services:


    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 this status may not be changed from the FedEx add-on setting page directly.

    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 find out 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 type of funds that 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 set of FedEx carrier services available for shipment. The carrier services you specify 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. If you want to change the order, you can drag-n-drop the carrier services to re-adjust their positions. During checkout, available shipping methods will display to your customers in the same order they are shown on the Carrier Services tab.

Did this answer your question?