Skip to main content

Customer Checkout Shipping

The customer-facing shipping flow integrates into the checkout process. Customers enter a destination address, review rate options, and select a shipping method.

Address Entry​

At checkout, the shipping section lets the customer enter their destination address. The system validates the address through the shipping provider. If the address is invalid, an error is shown. Valid addresses may be corrected automatically (e.g., ZIP+4, standardized street format).

Rate Options​

Once the address is valid, the system returns available carrier rates. Each rate shows:

  • Carrier — e.g., USPS, FedEx, UPS
  • Service level — e.g., Priority Mail, Ground
  • Cost — The shipping price
  • Estimated delivery — Number of days

If a carrier is excluded (e.g., the package exceeds their dimension limits), a diagnostic message explains why.

Package Count​

Alongside the rate options, the UI shows how many packages the order will ship in. This works whether or not package grouping is enabled — with grouping off, the count reflects one package per shippable order line.

Selecting and Purchasing a Label​

The customer selects one rate. When the order is finalized, the label is purchased automatically. The tracking number and estimated delivery date are stored on the order.

Shipping Address Entry Flow​

The shipping address entry is part of the multi-step order wizard. Each step uses Back and Next navigation buttons to move between steps:

  • Back — Returns to the previous step to make changes
  • Next — Validates the current step and moves forward

The address entry step validates the destination address before allowing the customer to proceed to rate selection.

When Shipping Is Not Available​

The shipping section will show an error if:

  • No shipping provider is configured
  • No default ship-from site is set
  • The destination address is invalid
  • The order contains no items with shipping dimensions