Skip to main content

The USPS Carrier allows you to offer domestic and international shipping services on the ground or airway conveniently. This is the service of the United States government and is famous for its flat rate shipping for smaller size and lightweight items. Their USPS Priority service is one of the most popular eCommerce shipping methods in Magento because it is flexible.

Thus, what credentials you need to connect your Magento 2 store to the USPS serve.

Configure USPS Carrier

Stay in the loop! Discover what’s new in the world of ecommerce.

Stay in the loop! Discover what’s new in the world of ecommerce.

  • Hidden
  • Hidden
  • No spam, just quality content. Your inbox is safe with us. For more details, review our Privacy Policy. We're protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
  • This field is for validation purposes and should be left unchanged.

Step 1: Create a USPS Shipping account

Must create a USPS Web Tools account first before configuring this shipping method. Then you will get a User ID and a link to the USPS test server.

Step 2: Apply USPS

  • On the Admin Panel,  Stores > Settings > Configurations .
  • On the left panel, under  Sales , select Shipping Method
  • Open the USPS section:
    • Accept to enable USPS method by choosing Yes in the  Enabled for Checkout  field.
    • Enter  Gateway URL  to calculate the USPS shipping rate. The default is ready to use, and don’t need to change.
    • Enter the  Title  for the name of the shipping method that is shown during the checkout process.
  • Copy the  User ID  and  Password  from your USPS account to the Magento configuration.
  • In the  Mode  field, choose one of the following options:
    • “Development” - Runs USPS in a test environment.
    • “Live” - Runs USPS in a live production environment.

If running USPS in the test environment, remember to set  Mode  to live when you come back.

HOW TO SETUP USPS SHIPPING METHOD IN MAGENTO 2 - USPS section

Step 3: Setup the Packaging Description

  • Select the option you need in the  Package Request Type  field to manage orders that are delivered as multiple packages as the following:
    • “Divide to Equal-Weight” - The shipment of multiple packages can be submitted as one request if the packages are divided by equal weight.
    • “Use Origin Weight” - Multiple packages must be submitted as separate requests if using origin weight as the basis of calculating the shipping cost.
  • Set the  Container  to the typical packaging type for the shipment as the following:
    • Variable
    • Flat-Rate Box
    • Flat-Rate Envelope
    • Rectangular
    • Non-Rectangular
  • Determine the  Size  that is acceptable for a package shipment.
    • Regular
    • Large
  • Select Yes for the  Machinable  if you want your typical packaged to be processed by a machine.
  • Set the number of the  Maximum Package Weight  option.
HOW TO SETUP USPS SHIPPING METHOD IN MAGENTO 2 - Packaging description

Step 4: Setup Handling Fees

  • Set  Calculate Handling Fee  to “Fixed” or “Percent”.
  • In the  Handling Applied  field, allow specifying how to calculate the handling fee.
  • Insert the amount of  Handling Fee .
HOW TO SETUP USPS SHIPPING METHOD IN MAGENTO 2 - Setup handling fees

Step 5: Assign Allowed Methods and Applicable Countries

  • Choose USPS method offered to your customers from the  Allowed Method  list.
  • In the  Free Method  field, select the USPS service you want to apply free shipping for.
  • In the  Free Shipping Amount Threshold  field, set the minimum number of the quantities for free USPS shipping.
  • Enter an error message in the  Displayed Error Message  box that will appear if UPS Shipping is not available.
HOW TO SETUP USPS SHIPPING METHOD IN MAGENTO 2 - Allowed methods
  • Set  Ship to Applicable Countries  to one of two options:
    • All Allowed Countries: USPS Shipping is supported by every country.
    • Specific Countries: USPS Shipping is only supported for selected countries.
  • Set  Show Method if Not Applicable  to Yes if you want to show USPS Shipping all time.
  • To create a log file with the details of USPS shipments, set to “Yes”.
  • Set the  Sort Order  on the Shipping Method on the checkout page.
  • Save Config  to finish.

Originally from the great team at MagePlaza.com

By Michael Cristancho

I'm a Digital Commerce and Experience evangelist who enjoys engaging in thought-provoking conversation and mutual exploration. I am a strong believer that learning never ends, and each day brings another opportunity to grow as an individual and professional.