Reading list Switch to dark mode

    Magento 2 Multi Vendor USPS Shipping Management Plugin

    Updated 13 October 2023

    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.

    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 – 

    Searching for an experienced
    Magento 2 Company ?
    Find out More


    • 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 by navigating through->Store->Configuration->Sales->Shipping Methods->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.

    Free Method


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

    USPS(United States Postal Service) Shipping Method Marketplace addon 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:


    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.



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


    This is how the created Shipment will appear.


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


    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.


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


    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 Select USPS Shipping Method At Checkout

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

    Buyer Select USPS Shipping Method At CheckoutNote:

    • 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.

    Marketplace USPS Shipping Management By Seller

    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.

    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.


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

    Marketplace USPS Shipping Management By Seller

    Shipment Information:-

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

    Marketplace USPS Shipping Management By Seller

    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.

    Marketplace USPS Shipping Management By Seller


    Marketplace USPS Shipping Management By Seller


    Sellers can also download the Pdf of shipping and invoice slips Under Marketplace-> My orders as shown below.
    Marketplace USPS Shipping Management By Seller

    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

    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