Laravel eCommerce USPS Shipping module lets store owners offer USPS shipping methods for fast, reliable, and convenient order delivery.
The module supports both domestic (US-based) and international shipping services.
Features
- The admin can enable or disable the Usps Shipping method.
- The admin can set the Usps shipping method name that will be shown from the front side.
- Allows admin to choose shipping methods under USPS shipping services.
- Dynamic shipping method for freight calculation.
- The module gets the shipping rates from the USPS Prices API with your USPS OAuth credentials.
- Sandbox Mode uses the USPS test environment, so the admin can test rates and labels before going live.
- The admin can choose Retail or Commercial USPS prices.
- The module buys the USPS shipping label when the admin ships a USPS order.
- It saves the USPS tracking number on the shipment automatically.
- The admin can download the USPS shipping label as a PDF from the order page.
- The admin can create the shipment and its label automatically when the customer places the order.
- If USPS refuses a label, the admin sees the USPS error and can retry it.
- The module converts USPS rates to the store currency.
Installation
This version of the module is compatible with Bagisto v2.5.0 and therefore needs PHP 8.4 or later.
Step 1: Extract Package
Unzip the extension package and merge the packages folder into your project root.
Step 2: Register Service Provider
Go to: bootstrap/providers.php file and add the following line under ‘providers’
use Webkul\UspsShipping\Providers\UspsShippingServiceProvider; return [ UspsShippingServiceProvider::class, ]
Then goto composer.json file and add following line under ‘psr-4’
"Webkul\\UspsShipping\\": "packages/Webkul/UspsShipping/src"
Run the composer dump-autoload command
composer dump-autoload
Run the command to install the USPS Shipping module
php artisan usps-shipping:install
Admin Configuration
After the successful installation of the module, the admin will have to configure the module.
Go to:
Admin Panel → Configure → Sales → Shipping Methods
Under the Shipping methods, all the shipping methods are visible in the admin panel including the USPS shipping.
Under the USPS there are several fields:-
Status: The admin can active or inactive the module from this field.
Title: Set the title displayed to customers during checkout.
Description: Add a description for the shipping method.
Sandbox Mode: When the admin turns it on, the module uses the USPS test environment (TEM) with USPS test credentials. When the admin turns it off, the module uses live USPS.
USPS Client ID: Enter the Client ID of your app from the USPS developer portal.
USPS Client Secret: Enter the USPS Client Secret provided by USPS.
Price Type: Choose Retail or Commercial USPS prices.
Account Type: Choose EPS or Permit. USPS charges the postage of every label to this account.
Account Number, Customer Registration ID (CRID), Mailer ID (MID) and Manifest Mailer ID (Manifest MID): Enter the values of your USPS business account. The module needs them to buy shipping labels, and you find them in your USPS Business Customer Gateway account.

Create shipment automatically when order is placed: When the admin turns it on, the module creates the shipment and its USPS label as soon as the customer places an order with USPS shipping.
Package Dimensions:
Enter the package dimensions in inches.
- Length
- Width
- Height
Allowed Methods: Select the USPS shipping services that will be available to customers during checkout.
The module offers USPS Ground Advantage, Priority Mail, Priority Mail Express, Parcel Select, Media Mail, Library Mail and Bound Printed Matter in the US, and Priority Mail International, Priority Mail Express International, First-Class Package International Service and Global Express Guaranteed abroad.

Front End
After successful configuration, customers can select USPS shipping methods during checkout.
Customers can:
- Place orders using USPS delivery methods
- View available USPS shipping services
- Choose their preferred shipping option

Once the order has been placed the customer can see all the details regarding the order in the order summary page including the shipping method used by the customer for the delivery of the package.

Order Management
The admin can see all the orders that have been placed under the admin panel by navigating to Sales>>Orders as shown in the image below:-

To view the details of any particular order the admin needs to click on the eye button.

After Clicking on the Invoice button the admin can create the invoice for that order as shown below:-
Here the admin also need to enter the quantity to invoice and click on the Save Invoice button.

To create a shipment click on the ship button in the order detail page.
The admin needs to enter the Quantity to Ship and also needs to select the inventory source of the product. For a USPS order, the module fills the Carrier Title and the Tracking Number from USPS.

Click on the Save shipment button.
The module then buys the USPS label, using the USPS service that the customer chose at checkout.
USPS Shipping Label
After USPS creates the label, the order page shows the USPS Labels panel. For every shipment, the panel shows the USPS tracking number with a link to the USPS tracking page.
The admin clicks the Download Label button to save the 4×6 USPS shipping label as a PDF file.
If USPS refuses the label, the panel shows the error message from USPS. The admin can fix the cause, such as the address or the account details, and click the Retry USPS Label button.
When Create shipment automatically when order is placed is on, the admin does not need to create the shipment. The module ships the order and buys the label as soon as the customer places it.
USPS labels are available for addresses in the United States and its territories.
The customers can see the tracking number of the shipment on their order page.
Support
So, that was much about the User Guide of Laravel eCommerce USPS Shipping for any queries or doubts reach out to us at [email protected]. You can also raise a ticket at our HelpDesk System.
Please explore our Laravel Development Services and Quality Bagisto Extensions.
Current Product Version - v2.5.0
Supported Framework Version - Bagisto v2.5.0
Be the first to comment.