Back to Top

Magento 2 Multi Vendor USPS Shipping Management Plugin

Updated 23 April 2024

Magento 2 Marketplace USPS Shipping Management provides USPS(United States Postal Service) shipping service for shipping the products.

USPS shipping service ships products all over the world.

Further, the Magento 2 USPS Shipping Marketplace Add-on calculates the shipping rate according to the seller’s product weight and the seller’s origin address.

Using this module, the admin can enable the option of USPS shipping method for the seller’s products.

Moreover, this allows the customers to choose the USPS shipping method on the checkout page if the seller has provided the USPS shipping method for their product.

Searching for an experienced
Magento 2 Company ?
Find out More

NOTE: This module is an add-on to the Magento 2 Marketplace Module. To use this module you must have installed Webkul Magento 2 Marketplace Module first.

Check the plugin working and overview at the storefront in the video mentioned below – 



  • The admin can enable or disable the USPS Shipping method.
  • The admin can set/change the USPS shipping method name that will be shown on the checkout page.
  • The sellers can download and print the USPS Label.
  • The admin can allow sellers to save his/her USPS Credentials.
  • The sellers can set/change their USPS details to manage the shipment of their orders.
  • USPS Shipping method will work with both admin’s/seller’s product.
  • Allow customers to choose the seller USPS shipping method.
  • Fully admin management.
  • The dynamic shipping method for freight calculation.
  • USPS Shipping method is available only for Regular and Large size products.
  • The admin can select the shipping method from the allowed shipping methods and can enter the amount for which the shipment will be free of cost by that shipping method.
  • This module allows the admin to select the applicable countries for this shipping method.
  • The admin can also select the operation for handling fee i.e. Fixed or percentage.
  • Using this module the admin can either add the handling fee Per Package/Per Order.

Install Extension from Webkul Store

#1 Download Module

Firstly, you need to log in to Webkul Store, go to My Account>My Purchased Products section, verify and then download and extract the contents of this zip folder on the system.

#2 Upload Folder

Once the module zip is extracted, follow path src>app and then copy the app folder into the Magento 2 root directory on the server as shown below:

Installation Of Show Price After Login for Magento2

#3 Run Commands

After uploading the module folder, you need to run the following commands in the Magento 2 root directory:

  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy
  • php bin/magento indexer:reindex
  • php bin/magento cache:flush

Install Extension from Magento Marketplace

If you have purchased this extension from the Magento Marketplace then please follow the below process or visit this link.

#1 Get Access Keys

You need to get access keys, navigate to My Profile in Magento Marketplace, then choose Access Keys in the My Products section.

excess key

Go to Magento 2 and then you need to copy both the Access Keys – Public Key and Private Key. These access keys will be needed in the next steps for authentication.


If access keys are not created earlier, click Create A New Access Key, enter any name and click OK.

new access key

#2 Update composer.json File

To know the component name and version number, go to your Magento Marketplace account section, My Profile>My Purchases, then find this extension to view the details.

Please note – Below is an example image, every extension will have its unique component name and version.

Zip file

After that, navigate to your Magento project directory and update your composer.json file in the following format.

composer require <component-name>:<version>

For example, to install version 4.0.0 of this extension you need to run the following command:

composer require webkul/marketplace-usps-shipping:5.0.0

#3 Enter Access Keys

Now you will need to enter the Access Keys that you obtained as explained in the first step #1 Get Access Keys. Wait for Composer to finish updating your project dependencies and make sure there aren’t any errors.

#4 Run Command

You need to run the following commands:

  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy
  • php bin/magento indexer:reindex
  • php bin/magento cache:flush

How to create USPS Shipping account

The user must create a USPS Shipping Account before configuring the shipping method.

After creating an account the user will get a mail with all the details like User ID, Password, link to the USPS test server.

usps Shipping

After submitting the form successfully, the user will see a confirmation message as shown in the image below.

usps shiping

Now the user will get an email with all the credentials to access the USPS server as shown in the image below.



Configuration Of The Module By Admin

After installation of the Magento 2 Marketplace USPS shipping module, the admin will be able to configure the module.

Navigate through->Store->Configuration->Sales->Delivery Methods->Marketplace USPS.

Marketplace USPS Configuration Settings

Enabled for Checkout: Set Enabled for Checkout as Yes to enable USPS Shipping method.

Gateway URL: Enter Gateway URL to calculate the USPS shipping rate.

Secure Gateway URL: Enter the Secure Gateway URL provided in the mail after creating the USPS Shipping Account.

Title: Enter the Title for the name of the shipping method that is shown during the checkout process.

User ID and Password: Enter the User ID and Password from your USPS account.

Mode: Choose one of the following options here:

  • Development – Runs USPS in a test environment.
  • Live – Runs USPS in a live production environment.

Container: Set the Container to the typical packaging type for the shipment as the following:

  • Variable
  • Flat-Rate Box
  • Flat-Rate Envelope
  • Rectangular
  • Non-Rectangular

Size: Determine the Size that you want to use for a package shipment.

  • Regular
  • Large

Machinable: Select Yes for the Machinable if you want your package to be processed by a machine.


Maximum Package Weight: Here the admin needs to specify the maxium weight of the package that is applicable for this shipping method.

Calculate Handling Fee: By using the Dropdown the admin can select the operation for calculating the handling fees. There are two options available as:

  • Fixed
  • Percentage

Handling Applied: From the given dropdown options the admin can select the way of applying the handling fees. The handling fees can be applied Per order/Per Package.

Handling Fees: Here the admin can define the handling fees.

Allowed Methods: Choose the USPS method offered to your customers from the Allowed Method list.


Enable Free Shipping Threshold: By using this option the admin can Enable/Disable the Free Shipping Threshold.

Methods Available

Free Method: The admin can select the shipping method and that will be free of cost.

Free Shipping amount Threshold: Here the admin can define the amount for which the above-selected shipping method will be free of cost.

select USPS shipping method at checkout


The customer will get free shipping only for that shipping method which the admin has selected from the backend and also the free shipping will be available only for those products whose price is less than equal to the Free Shipping amount Threshold.

Ship to Applicable Countries: By using this the admin can select any of these two options All Allowed countries/Specific Countries from the dropdown.

Ship to Specific Countries: If the admin has selected specific countries in the above section then here, he needs to select the countries where the shipping is applicable.

Allow Seller to Save Usps Details: Set Yes for the seller to save USPS Details.

Displayed Error Message: Enter an error message in the Displayed Error Message box that will appear if USPS Shipping is not available.

Show Method if Not Applicable: Set Show Method if Not Applicable to Yes if you want to show USPS Shipping all time.

Debug: To create a log file with the details of USPS shipments, set Debug to Yes.

NOTE: The User must create a USPS Shipping Account before configuring the shipping method.

Admin’s End Workflow

USPS(United States Postal Service) Shipping Method Marketplace add-on works for the admin’s product as well.

The admin can save USPS configuration details from the admin panel as discussed above. 

When the buyers place an order, they can see the Webkul USPS Shipping method on the shopping cart page, as shown below:

select USPS shipping method at checkout

The customer can choose to purchase the admin’s product and can place an order for the same by opting for Webkul USPS Shipping as the delivery method on the shopping cart page.

Further, the admin can manage the order and can generate shipping.


From the Admin Panel, the admin can view and manage the orders by navigating through Sales->Order.

Admin View order information


Moreover, the admin can generate an invoice for his orders as shown below:

Admin view invoice

This is how the created Shipment will appear.

Admin shipment view

In the end, the admin can successfully print the Shipping Label for the order to be shipped by USPS Shipping Method.

admin download packing slip 

Seller Settings – Magento 2 Marketplace USPS Shipping

Magento 2 Marketplace USPS Shipping: Sellers can save their USPS configuration details.

For this, the sellers will provide their details in the Usps Userid and Usps Password fields and proceed by clicking on the “Save” button.

vendor USPS configuration

The seller will now add the shipping origin address to his account by navigating to Shipping Setting menu option as per the below image.

vendor shipping origin

Also, the sellers can add Shipping, Invoice, Tax, Vat information under Manage Print Pdf Header Info as shown below.


NOTE: The “USPS Configuration” option in the seller panel will only be visible when admin sets the “Enabled for Checkout” and “Allow Sellers to Save Usps Details” to “Yes” in the admin panel else not.

Buyer Select USPS Shipping Method At Checkout

When Buyer will place an order for seller’s product, the buyer can see Magento 2 Marketplace USPS Shipping under Shipping Methods as per the image.

Buyer can also see the selected shipping method under Order Summary section as shown below.

Buyer view selected USPS Shipping method on place order page


  • In Magento 2 Marketplace USPS Shipping module, the shipping rate will be calculated according to seller’s product weight and seller origin(Billing address) address through API.
  • Magento 2 Marketplace USPS Shipping doesn’t work for the admin/seller’s product with more than one warehouse for a product.

Marketplace USPS Shipping Management By Seller

The seller can see the orders under “My Order History” as per the image below.

vendor view all orders

If admin sets the “Allow Seller to Manage Order” option to “Yes” then the seller can manage the orders from the front-end. This enables the seller to generate invoices, tracking number, and shipment for the orders of their products.vendor view order information

Even the seller can notify the customers by sending them emails, cancel/refund the order and even print the order. To generate the USPS shipping label sellers need to check the checkbox for USPS shipment as shown below.vendor select usps shipping method


Once the seller generates the shipment and invoice, the seller will able to see complete order details.

Shipment Information:-

Here, the sellers will be able to print the Shipment Slips and send tracking information.


The seller can click on USPS Shipment slip to print USPS Label as shown below.

USPS Label:

Marketplace USPS Shipping Management By Seller

The seller can download the Shipping and Invoice slip very easily. In this slip, you can also see the company logo and address, vat, tax information which is entered by the seller under Manage Print Pdf Header Info tab.


Shipping Label Generating option is not working with free API Credentials, first You need to purchase credentials for this feature.

vendor can download invoice slip


vendor download packing slips


Sellers can also download the Pdf of shipping and invoice slips Under Marketplace-> My orders as shown below.
vendor download shipping slip

Download all Invoice Slips: 

After clicking on download option a pop-up window will appear, here you will enter the date up to which you want to download the Invoice Slips.
Marketplace USPS Shipping Management By Seller

Download all Packaging Slips: 

Similarly, you will enter the date up to which you want to download the Packaging Slips.

Marketplace USPS Shipping Management By Seller

That’s all for the Magento 2 Marketplace USPS Shipping, still, have any issue feel free to add a ticket and let us know your views to make the module better at HelpDesk System.

Current Product Version - 5.0.2-p1

Supported Framework Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x

Blog Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x
  • Version 2.0.x, 2.1.x, 2.2.x, 2.3.x
  • Version 2.0.x, 2.1.x, 2.2.x, 2.3.x, 2.4.x
. . .

Leave a Comment

Your email address will not be published. Required fields are marked*

Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Table of Content