Checkout Step 3: Choose Shipping Method

In this guide, you'll learn how to implement the third step of the checkout flow, where the customer chooses the shipping method to receive their order's items. While this is typically the third step of the checkout flow, you can change the steps of the checkout flow as you see fit.

Shipping Flow in Storefront Checkout#

To allow the customer to choose a shipping method, you:

1. Retrieve the available shipping options for the cart using the List Shipping Options API route and show them to the customer.
2. For shipping options whose price_type=calculated, you retrieve their calculated price using the Calculate Shipping Option Price API Route.
   • The Medusa application calculates the price using the associated fulfillment provider's logic, which may require sending a request to a third-party service.
3. When the customer chooses a shipping option, you use the Add Shipping Method to Cart API route to set the cart's shipping method.

How to Implement the Shipping Flow in Storefront Checkout?#

For example:

In the example above, you:

• Retrieve the available shipping options of the cart to allow the customer to select from them using the List Shipping Options API route.
• For each shipping option, you retrieve its calculated price from the Medusa application using the Calculate Shipping Option Price API Route.
• Once the customer selects a shipping option, you send a request to the Add Shipping Method to Cart API route to update the cart's shipping method using the selected shipping option.

data Request Body Parameter#

When calculating a shipping option's price using the Calculate Shipping Option Price API Route, or when setting the shipping method using the Add Shipping Method to Cart API route, you can pass a data request body parameter that holds data relevant for the fulfillment provider.

For example, you may pass a custom carrier code to the data parameter to identify the carrier of the shipping option if your fulfillment provider requires it.

This isn't implemented here as it's different for each provider. Refer to your fulfillment provider's documentation on details of expected data, if any.