After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

FedEx

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

FedEx is one of the world’s largest shipping service companies, providing air, freight, and ground shipping services with several levels of priorities.

FedEx shipping options at checkout

FedEx now uses dimensional weight to determine some shipping rates. Dimensional weight, sometimes called volumetric weight, is a common industry practice that bases the transportation price on a combination of weight and package volume. In simple terms, dimensional weight determines the shipping rate based on the amount of space a package occupies in the cargo area of the carrier. Dimensional weight is typically used when a package is relatively light compared to its volume.

Step 1: Register for FedEx Web Services Production

You must create a FedEx merchant account and register for FedEx Web Services Production Access. After creating a FedEx account, read through the production account information page, then click the Obtain Production Key link at the bottom of the page to register and obtain a key.

Make sure to copy or write down the authentication key. You will need it to set up FedEx in your Magento shipping settings.

Step 2: Enable FedEx for your store

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Shipping Methods.

  3. Expand the FedEx section.

    FedEx account settings

  4. Set Enabled for Checkout to Yes.

  5. Enter an appropriate Title to identify the FedEx shipping method during checkout.

  6. Enter the following information from your FedEx account:

    • Account ID
    • Meter Number
    • Key
    • Password
  7. If you have set up a FedEx sandbox and want to work in the testing environment, set Sandbox Mode to Yes.

    Remember to set Sandbox Mode to No when you are ready to offer FedEx as a shipping method to your customers.

Step 3: Specify package type and handling fee

  1. Set the Packages Request Type to the option that best describes your preference when splitting an order into multiple shipments:

    • Divide to equal weight (one request)
    • Use origin weight (few requests)

    FedEx package settings

  2. Select the type of Packaging typically used to ship products from your store. Options include:

    • FedEx Envelope
    • FedEx Pak
    • FedEx Box
    • FedEx Tube
    • FedEx 10kg Box
    • FedEx 25kg Box
    • Your Packaging
  3. Set Dropoff to the pick-up method that will be used for delivery:

    Regular Pickup If you have a high volume of shipments, it can be cost effective to make arrangements with FedEx for regular pickups.
    Request Courier You must call and request a FedEx courier to pick-up shipments.
    Drop Box You must drop off shipments at your nearby FedEx drop box.
    Business Service Center You must drop off shipments at your local FedEx business service center.
    Station You must drop off shipments at your local FedEx station.
  4. Set Weight Unit to the unit of measurement that is used in your locale:

    • Pounds
    • Kilograms
  5. Enter the Maximum Package Weight allowed for FedEx shipments.

    The default FedEx maximum weight is 150 lbs. Consult your shipping carrier for more information. We recommend using the default value, unless you have made special arrangements with FedEx.

  6. (Optional) Add a handling fee to the amount charged by FedEx, which is not visible during checkout.

    FedEx handling fee Settings

    • Set Calculate Handling Fee to one of the following:

      • Fixed Fee
      • Percentage
    • In the Handling Applied list, choose one of the following methods for managing handling fees:

      • Per Order
      • Per Package
  7. Enter the Handling Fee as either a fixed amount or percentage, depending on the method of calculation.

Step 4: Specify delivery and methods

FedEx allowed delivery methods

  1. Set Residential Delivery to one of the following, depending on whether you sell Business-to-Consumer (B2C) or Business-to-Business (B2B).

    Yes For B2C residential deliveries.
    No For B2B residential deliveries.
  2. Set Allowed Methods to each method of shipment that you want to offer.

    When choosing methods, take into consideration your FedEx account, the frequency and size of your shipments, and if you allow international shipments. You can offer as many or as few methods as you want. Options include:

    • Europe First Priority
    • Delivery day options: 1 Day Freight, 2 Day Freight, 2 Day, 2 Day AM, 3 Day Freight
    • Domestic options–Express Saver, Ground, First, Overnight, Home Delivery, Standard Overnight
    • International options–International Economy, Intl Economy Freight, International First, International Ground, International, Priority Intl
    • Priority options–Freight, Priority Overnight
    • Smart Post–If offering the Smart Post method, enter the Hub ID.
    • Freight options–Freight, National Freight
  3. For Free Method, choose the method you prefer to use for free shipping and do the following:

    • Set Free Shipping Amount Threshold to one of the following:

      Enable If offering Free Shipping with Minimum Order, enter the Minimum Order Amount for Free Shipping.
      Disable Does not apply free FedEx shipping to any orders.

      This is similar to the standard Free Shipping method, but appears in the FedEx section during checkout, so customers know which method is used for their order.

    • For Free Shipping Amount Threshold, enter the minimum amount for an order to qualify for free shipping.

  4. The Displayed Error Message text box is preset with a default message. You can leave this as is or edit as needed.

Step 5: Complete the configuration

FedEx applicable countries and display settings

  1. Set Ship to Applicable Countries to one of the following:

    • All Allowed Countries
    • Specific Countries

    If applicable, set Ship to Specific Countries to each country where your customers are allowed to ship by FedEx.

  2. If you want to keep a log of all communication between your store and the FedEx system, set Debug to Yes.

  3. Set Show Method if Not Applicable to one of the following:

    Yes Shows all FedEx shipping methods to customers, regardless of their availability.
    No Shows only the FedEx shipping methods that apply to the order.
  4. If you offer multiple shipping carriers/methods, enter a number for Sort Order to determine where in the sequence FedEx appears.

    This is relative to the other shipping carriers/methods. (0 = first, 1 = second, 2 = third, and so on.)

  5. Click Save Config.