> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.dintero.com/feedback

```json
{
  "path": "/docs/checkout/shipping-address-callback",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Shipping address callback

> Handle Dintero Checkout shipping address change callbacks and return updated shipping options to the customer based on the new shipping address.

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](/docs/checkout/shipping-options) for the given shipping address.

Link to [the API specification for the callback endpoint](/payments-api.html#operation/example_shipping_address_callback_url). 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.

```json title="Item with correction" theme={null}
{
  "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:

```json theme={null}
{
  "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`:

```json theme={null}
{
  "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.

```json theme={null}
{
  "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.
</Tip>

[Dintero Web SDK]: https://github.com/Dintero/Dintero.Checkout.Web.SDK