> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flow

## Article: Sample Flow

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/shipping-rates/shipping-rates-integration-service-plugin/sample-flow.md

## Article Content:

# Sample Flow

This article presents a sample flow you can support. You aren't limited to this exact flow, but it can be a helpful jumping off point as you plan your Shipping Rates integration.

## Display custom shipping rates for eCommerce orders

1. A customer logs on to the merchant’s Wix site and starts adds a product to the cart or checkout.

2. Wix sends a Get Shipping Rates service plugin request to your app. The payload will include some or all of the fields described in the Body Params and example sections of the [Get Shipping Rates reference](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/shipping-rates/shipping-rates-integration-service-plugin/get-shipping-rates.md).

3. Your Shipping Rates integration triggers the required flow on its platform and processes the request.

    Wix expects an object containing the shipping rates, and either a 4xx HTTP status code (and some errors) or a 200 HTTP status code.
    
    Example of a successful response from your app:
    
    ```json
    {
      "shippingRates": [
        {
          "code": "usps_international",
          "title": "USPS - International",
          "logistics": {
            "deliveryTime": "2-5 days"
          },
          "cost": {
            "price": "15",
            "currency": "USD",
            "additionalCharges": [
              {
                "price": "10",
                "type": "HANDLING_FEE",
                "details": "Handling fee of $5 applied for fragile items."
              }
            ]
          }
        }
      ]
    }
    ```

    Example of an error:
    
    ```json
    {
      "errors": [
        {
          "code": "MISSING_POSTAL_CODE",
          "message": "Postal Code was missing from request"
        }
      ]
    }
    ```

4. The Wix site displays the shipping rate/s on the cart or checkout page (depending on where the customer is selecting the shipping option). The customer can confirm the shipping rate before proceeding to payment.