Shipping address callback

When there are changes in the shipping address in the checkout, a callback is sent from Dintero's services to the endpoint that you have specified in session.express.example_shipping_address_callback_url with an updated order including the new address.

The webshop should update the webshop state/order with the new shipping address, and return a list of available shipping options for the given shipping address.

Link to the API specification for the callback endpoint. Note that the request body is what Dintero will post to your endpoint and the response is what your endpoint returns back to Dintero.

If the checkout is embedded, the Dintero Web SDK will call onSession whenever the session is updated, with the event SessionUpdated.

Compatibility with "one click" Apple Pay and Google Pay

In order to support one click express payments via Apple Pay and Google Pay your endpoint must support returning shipping options when the session.order.shipping_address in the request body from Dintero’s systems contains only country and postal_code.

Troubleshooting

If correction item is added to the order

If the implementation has problems with items of the type correction, you might have problems with the shipping address callback.

Item with correction

{
  "id": "correction-mc7nt6LjqgCejGGLNHpFMq",
  "amount": -10000,
  "line_id": "correction-mc7nt6LjqgCejGGLNHpFMq",
  "quantity": 1,
  "description": "Correction"
}

This can happen when handling the callback and responding with an updated order with the wrong order.amount.

To solve this, make sure that order.amount contains the amount from the shipping option which is currently chosen.

Example

If the callback contains the following:

{
  "order": {
    "items": [
      {
        "id": "item-1",
        "line_id": "item-1",
        "amount": 10000,
        "vat": 25,
        "vat_amount": 2000,
        "quantity": 1
      }
    ],
    "amount": 20000,
    "vat_amount": 4000,
    "currency": "NOK",
    "shipping_option": {
      "id": "shipping",
      "line_id": "shipping",
      "amount": 10000,
      "vat": 25,
      "vat_amount": 2000
    }
  }
}

then, if the order is not changed, the response needs to contain the 10000 from the request order.shipping_option.amount:

{
  "order": {
    "items": [
      {
        "id": "item-1",
        "line_id": "item-1",
        "amount": 10000,
        "quantity": 1,
        "vat": 25,
        "vat_amount": 2000
      }
    ],
    "amount": 20000,
    "vat_amount": 4000,
    "currency": "NOK"
  }
}

If the tax of the item has changed from 25% to 20% you should still provide the same amount from the callback payload. If the shipping option price has changed, we will adjust the total price of the whole order when we choose the shipping option from the new list of shipping options.

{
  "order": {
    "items": [
      {
        "id": "item-1",
        "line_id": "item-1",
        "amount": 9600,
        "quantity": 1,
        "vat": 20,
        "vat_amount": 1600
      }
    ],
    "amount": 19600,
    "vat_amount": 3600,
    "currency": "NOK"
  }
}

tip

The use-cases for when the order changes when the address is changed are:

• The new address is in another country or state, and the tax is different for the new location
• Other, less probable ones (e.g. if the customer is from a certain location, they have to buy a specific item)

If these use cases don't apply to you, it's best to respond to the callback with just the new shipping options.