User Guide for Laravel SaaS USPS Shipping

Laravel SaaS USPS Shipping lets SaaS tenants enable the USPS shipping method for their stores.

It calculates the shipment cost from the tenant’s origin address to the delivery location automatically.

Each tenant can enable USPS Shipping for their store and choose the allowed USPS shipping services.

Note – This is a SaaS add-on, so you need to install the Laravel eCommerce Multi Company SAAS Module first.

Looking to sell booking type products in your multi tenant SaaS Laravel store as well?

Check out the Multi Tenant Saas Booking Product extension.

• Tenants can enable or disable the USPS Shipping method for their store.
• Tenants can set the title and description shown to customers at checkout.
• Tenants can select which USPS shipping services are offered to customers.
• Tenants can configure package length, width, and height for rate calculation.
• Tenants can enable Sandbox mode to test the integration before going live.

• Bagisto v2.4.9
• Laravel SAAS v2.4.9.1
• Laravel USPS Shipping v2.4.10.0

• Unzip the respective extension zip and then merge “packages” folders into the project root directory.
• Add the following PSR-4 autoload entries to the root composer.json under the autoload.psr-4 section:

"Webkul\\UspsShipping\\": "packages/Webkul/UspsShipping/src",
"Webkul\\UspsShippingSaas\\": "packages/Webkul/UspsShippingSaas/src"

• Run the following command to refresh the autoload files:

composer dump-autoload

• Add the following service providers to bootstrap/providers.php:

use Webkul\UspsShipping\Providers\UspsShippingServiceProvider;
use Webkul\UspsShippingSaas\Providers\UspsShippingSaasServiceProvider;

return [
    UspsShippingServiceProvider::class,
    UspsShippingSaasServiceProvider::class,
];

Now execute the project on your specified domain.

After installation, the super admin logs in and navigates to Configure > Sales > Shipping Methods > USPS Shipping.

In the SaaS environment, this area shows an informational notice about the USPS integration for tenants.

Operational settings, such as the Client ID, Client Secret, and Sandbox mode, are configured by each tenant.

Tenants set these values from their own administration panel under Configure > Sales > Shipping Methods.

Note: The USPS module uses OAuth 2.0 authentication, so it needs a USPS Client ID and USPS Client Secret.

The legacy User ID and Password fields are gone. A Sandbox toggle now switches between test and live modes.

After installation, the tenant sets the origin address under Configure > Sales > Shipping Settings.

Under Shipping Methods, every shipping method is visible in the tenant panel, including USPS Shipping.

On the above page, the tenant fills in all the details for the origin address, as shown above.

Under the USPS method, there are several fields:-

Status: Enable or disable the USPS Shipping method. When enabled, it appears as a shipping option for eligible orders at checkout.

Title: Enter the title that will be displayed to customers as the shipping method name during checkout.

Description: Provide a short description of the USPS Shipping method. This information is shown to help customers understand the shipping service.

Sandbox Mode: Enable this option to test USPS shipping integration using USPS sandbox credentials without affecting live shipments.

USPS Client ID: Enter the Client ID provided by USPS. This credential is required to authenticate API requests.

USPS Client Secret: Enter the Client Secret associated with your USPS account. It is used together with the Client ID for secure API authentication.

Length: Enter the package length in the configured unit of measurement. This value is used for shipping rate calculations.

Width: Enter the package width in the configured unit of measurement. This value helps USPS calculate accurate shipping rates.

Height: Enter the package height in the configured unit of measurement. USPS considers this dimension when generating shipping quotes.

Allowed Methods: Select the USPS shipping services offered to customers at checkout. Only the chosen methods appear as options.

After the tenant configures USPS Shipping, customers can use it for delivery at checkout.

The customer can select from the allowed services according to the requirements.

Once the order is placed, the customer views the order details by tapping the order number.

The customer sees the shipping method and delivery cost for the package, as shown below.

The tenant can see all the orders placed under the tenant panel by navigating to Sales > Orders, as shown below.

The tenant can view the details of any particular order.

The tenant can generate an order invoice by clicking Invoice and setting the invoice quantity, as shown below.

After creating the invoice, the tenant can check the order status, which shows Processing with the invoice generated.

The invoice page opens when the tenant clicks the view action on the order page.

After the invoice is generated, the tenant creates a new shipment by clicking Ship, as shown below.

After creating the shipment, the order status changes to Completed, as shown below.

The shipment page opens when the tenant clicks the view action on the shipment. The tenant sees the full shipment details there.

The tenant can refund an order by clicking Refund, then creating a refund request, as shown below.

After creating the refund request, the tenant can check it in the refund section.

The tenant can view the completed order refund, as shown below.

The tenant can view the details of any particular order after it is closed.

That was the User Guide of the Laravel SaaS USPS Shipping module. For any queries, 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.