Dynamic shipping

When a customer checks out using Roqqett Checkout you can offer them dynamic shipping rate instead of fixed, hardcoded rates. This allows you to offer the precise rates you have arranged and allow your customer to select the most appropriate shipping option for their order. When using the dynamic shipping rates the total cart cost recalculates in real-time.

Roqqett's dynamic shipping works by retrieving the appropriate shipping rates from the service your business uses to manage and calculate shipping rates. Once a customer has selected their shipping address in Roqqett Checkout, Roqqett will send the contents of the basket and the shipping address to the service you use via API. Roqqett then expects your service to determine the rates and send them back to Roqqett, which then provides to your customer for selection.

Technically, as you can see above, the checkout instance will make a POST callback to the endpoint (defined by the merchant) that contains the current content of the basket along with the shipping address. The merchant endpoint must then return a list of shipping rates/options that are then presented to the customer on the checkout screen for selection.

The callback response timeout is 5 seconds, at which point the UI will alert and prompt the customer to retry loading the shipping options which if clicked will trigger a secondary callback attempt.

*Example Request

{
  "rate": {
    "destinationAddress": {
      "addressLine1": "8th Floor ",
      "addressLine2": "100 Bishopsgate",
      "city": "London",
      "postcode": "EC2N 4AG",
      "countryCode": "GB"
    },
    "basket": {
      "subTotal": 0,
      "items": [
        {
          "lineId": "1",
          "quantity": 2,
          "productId": "2389472398",
          "productName": "A £20 note",
          "total": 4000,
          "unitPrice": 2000,
          "taxRate": 0,
          "taxTotal": 0
        }
      ]
    },
    "merchantCartId": "QY9CvCU5Ru45Btv7iF",
    "cartId": "3a4b419a-c617-11ec-9d64-0242ac120002"
  }
}

[
  {
    "currency": "GBP",
    "totalPrice": 2,
    "description": "3 business days",
    "preSelected": true,
    "serviceCode": "SD5",
    "serviceName": "Standard delivery",
    "maxDeliveryDate": "2022-02-13T17:12:34+0100",
    "minDeliveryDate": "2022-02-13T09:12:34+0100"
  },
  {
    "currency": "GBP",
    "totalPrice": 4,
    "description": "2 business days",
    "serviceCode": "ED2",
    "serviceName": "Express delivery",
    "maxDeliveryDate": "2022-02-12T17:12:34+0100",
    "minDeliveryDate": "2022-02-12T09:12:34+0100"
  },
  {
    "currency": "GBP",
    "totalPrice": 8,
    "description": "24 hours",
    "serviceCode": "NDD1",
    "serviceName": "Next day delivery",
    "maxDeliveryDate": "2022-02-11T17:12:34+0100",
    "minDeliveryDate": "2022-02-11T09:12:34+0100"
  },
  {
    "currency": "GBP",
    "totalPrice": 0,
    "description": "Free ",
    "serviceCode": "Free5D",
    "serviceName": "Free delivery",
    "maxDeliveryDate": "2022-02-15T17:12:34+0100",
    "minDeliveryDate": "2022-02-15T09:12:34+0100"
  }
]

Roqqett dynamic shipping also allows the merchant to define a default shipping rate. To do this, you can optionally set the preSelected parameter to true in a rate object that will make that shipping option the default selected in the checkout. This means that UI will automatically pre-select this option and the user will not be shown the other options unless they choose to.

❗️

Only compatible with Roqqett Checkout

Dynamic shipping is a feature that is only compatible with Roqqett Checkout so

Before you begin

• Ensure you have registered and have your API keys.
• Ensure you decided which integration method you will be using out of Plugin integration or Javascript integration.
• Ensure your Organisation settings are configured correctly in the Roqqett portal.
• Ensure you understand the payment flow - this page provides some additional detail.
  
  

Create a Roqqett Pay instance for your business

Log into the Roqqett portal