Dynamic shipping

Offer your customers intelligent, calculated shipping rates when checking out



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.

How does it work?


(click to enlarge)

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"

** Example Response **
    "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"

Default shipping rate

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.

Setup instructions


Only compatible with Roqqett Checkout

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

Before you begin

Create a Roqqett Pay instance for your business

Log into the Roqqett portal

Any questions? Ask us via chat here (bottom right) or on our help center.