Skip to main content
POST
https://checkout.dintero.com/v1/
/
examples
/
shipping_address_callback_url
Address Update
curl --request POST \
  --url https://checkout.dintero.com/v1/examples/shipping_address_callback_url \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": {
    "return_url": "https://example.com/accept",
    "callback_url": "https://example.com/callback?method=GET",
    "merchant_terms_url": "https://example.com/terms.html"
  },
  "order": {
    "amount": 72200,
    "currency": "NOK",
    "merchant_reference": "<string>",
    "vat_amount": 13660,
    "merchant_reference_2": "<string>",
    "event_reference": "<string>",
    "shipping_address": {
      "first_name": "John",
      "last_name": "Doe",
      "address_line": "<string>",
      "address_line_2": "<string>",
      "co_address": "Land Lord",
      "business_name": "<string>",
      "postal_code": "0349",
      "postal_place": "Oslo",
      "country": "NO",
      "phone_number": "<string>",
      "email": "<string>",
      "latitude": 123,
      "longitude": 123,
      "comment": "<string>",
      "organization_number": "<string>",
      "organization_type": "<string>",
      "customer_reference": "<string>",
      "cost_center": "<string>"
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "address_line": "<string>",
      "address_line_2": "<string>",
      "co_address": "Land Lord",
      "business_name": "<string>",
      "postal_code": "0349",
      "postal_place": "Oslo",
      "country": "NO",
      "phone_number": "<string>",
      "email": "<string>",
      "latitude": 123,
      "longitude": 123,
      "comment": "<string>",
      "organization_number": "<string>",
      "organization_type": "<string>",
      "customer_reference": "<string>",
      "cost_center": "<string>"
    },
    "partial_payment": false,
    "items": [
      {
        "amount": 2000,
        "quantity": 2,
        "line_id": "1",
        "description": "Forsvinnignspølse",
        "vat": 20,
        "id": "10"
      },
      {
        "amount": 6600,
        "quantity": 2,
        "line_id": "2",
        "description": "Vissvossafår på neppebrød",
        "vat": 20,
        "id": "6",
        "eligible_for_discount": true,
        "is_changed": true,
        "gross_amount": 10000,
        "discount_lines": [
          {
            "amount": 4400,
            "discount_type": "customer",
            "discount_id": "ed960ace-eb16-4e2e-ae52-b27647ccae8d",
            "description": "Vossafestpris",
            "line_id": 1
          }
        ]
      },
      {
        "amount": 59700,
        "quantity": 3,
        "line_id": "3",
        "description": "Luftboller",
        "vat": 20,
        "id": "1"
      }
    ],
    "discount_lines": [
      {
        "amount": 4400,
        "percentage": 44,
        "discount_type": "customer",
        "discount_id": "766da0ef-9283-42bd-b012-0582344ec53c",
        "description": "<string>",
        "line_id": 1
      }
    ],
    "discount_codes": [
      "SUMMER20"
    ],
    "gift_cards": [
      {
        "type": "dintero.wallets",
        "card_id": "<string>",
        "amount": 123,
        "masked_card_token": "<string>"
      }
    ],
    "payout_destination_id": "<string>"
  },
  "configuration": {
    "auto_capture": true,
    "channel": "ecommerce",
    "publish": [
      {
        "channel": "sms",
        "type": "checkout-link"
      }
    ],
    "active_payment_types": {
      "enabled": true
    },
    "default_payment_type": "bambora.applepay",
    "bambora": {
      "type": "payment_type"
    },
    "dintero": {
      "type": "payment_type"
    },
    "dintero_psp": {
      "type": "payment_type"
    },
    "instabank": {},
    "netaxept": {
      "type": "payment_type"
    },
    "payex": {
      "dynamic_descriptor": "<string>"
    },
    "collector": {
      "type": "payment_type",
      "dynamic_descriptor": "<string>"
    },
    "klarna": {
      "type": "payment_type"
    },
    "kravia": {
      "type": "payment_type"
    },
    "two": {
      "type": "payment_type"
    },
    "santander": {
      "type": "payment_type"
    },
    "seitatech": {
      "type": "payment_type"
    },
    "swish": {
      "type": "payment_type"
    },
    "payout": {
      "dynamic_payout_destination_ids": [
        {
          "type": "order_store_id",
          "order_store_id": "STORE_123",
          "order_payout_destination_id": "PD_123",
          "overwrite_payout_destination_id": false
        }
      ]
    },
    "allow_express_wallet_payment": false,
    "discounts": {},
    "theme": {
      "backdrop": "<string>",
      "primary": "<string>",
      "cardRadius": "<string>",
      "buttonRadius": "<string>"
    },
    "countries": {
      "preferred_country": "<string>",
      "allow_countries": [
        "<string>"
      ],
      "deny_countries": [
        "<string>"
      ]
    },
    "default_customer_type": "b2c",
    "allow_different_billing_shipping_address": [],
    "merchant": {
      "id": null,
      "logo_url": "<string>",
      "name": "TKP tech AS",
      "country": "NO"
    }
  },
  "id": "<string>"
}
'
{
  "shipping_options": [
    {
      "id": "bring-pick-up-00001",
      "line_id": "bring-pick-up-00001-location-0a1f6b",
      "amount": 3900,
      "title": "Standard",
      "operator": "Bring",
      "countries": [
        "NO"
      ],
      "vat_amount": 975,
      "vat": 25,
      "description": "Pick up at your nearest postal office",
      "delivery_method": "pick_up",
      "operator_product_id": "pick-up-00001-location-0a1f6b",
      "eta": {
        "working_days": [
          1,
          2
        ],
        "shipping_day_of_week": 3,
        "arrival_day_of_week": 3,
        "starts_at": "2020-10-14T19:00:00Z",
        "ends_at": "2020-10-14T20:00:00Z"
      },
      "time_slot": {
        "starts_at": "2020-10-14T19:00:00Z",
        "ends_at": "2020-10-14T20:00:00Z"
      },
      "pick_up_address": {
        "first_name": "John",
        "last_name": "Doe",
        "address_line": "<string>",
        "address_line_2": "<string>",
        "co_address": "Land Lord",
        "business_name": "<string>",
        "postal_code": "0349",
        "postal_place": "Oslo",
        "country": "NO",
        "phone_number": "<string>",
        "email": "<string>",
        "latitude": 123,
        "longitude": 123,
        "comment": "<string>",
        "organization_number": "<string>",
        "organization_type": "<string>",
        "customer_reference": "<string>",
        "cost_center": "<string>",
        "website_url": "<string>",
        "opening_hours": {
          "open_now": true,
          "periods": [
            {
              "opens_at": "08:00",
              "closes_at": "16:00",
              "day_of_week": 1
            }
          ],
          "timezone": "Europe/Oslo"
        },
        "distance": 123
      },
      "metadata": {
        "operator_dest": "XAB1239",
        "number_x": 1921
      },
      "environmental_data": {
        "description": "Fossil free",
        "details": [
          {
            "label": "Carbon offset",
            "value": "1KG CO2"
          }
        ]
      },
      "thumbnail_url": "<string>",
      "pay_in_store": {
        "type": "full"
      },
      "fee_split": {
        "type": "proportional",
        "destinations": [
          "<string>"
        ]
      },
      "splits": [
        {
          "payout_destination_id": "seller-1",
          "amount": 29700
        }
      ],
      "shipment_id": "<string>",
      "shipment_items": [
        {
          "line_id": "line-id-1",
          "quantity": 123
        }
      ]
    }
  ],
  "order": {
    "amount": 29990,
    "currency": "NOK",
    "vat_amount": 6000,
    "items": [
      {
        "id": "item_01",
        "groups": [
          {
            "id": "B234",
            "name": "Stol"
          }
        ],
        "line_id": "1",
        "version": 123,
        "description": "Stablestol",
        "quantity": 1,
        "amount": 2000,
        "vat_amount": 400,
        "vat": 20,
        "unit_volume": 123,
        "unit_weight": 123,
        "unit_dimensional_weight": 123,
        "type": "physical",
        "fee_split": {
          "type": "proportional",
          "destinations": [
            "<string>"
          ]
        },
        "splits": [
          {
            "payout_destination_id": "seller-1",
            "amount": 29700
          }
        ],
        "thumbnail_url": "<string>",
        "emd": {
          "event": [
            {
              "event_name": "Michael Jackson",
              "event_company": "Diamond Events",
              "genre_of_event": "Pop",
              "start_time": "2023-08-16T15:00:00Z",
              "end_time": "2023-08-16T16:00:00Z",
              "ticket_delivery_method": "email",
              "ticket_delivery_recipient": "recipient@mail.com",
              "arena_name": "Oslo Spektrum",
              "arena_location": {
                "city": "Oslo",
                "country": "NO",
                "street_address": "Sonja Henies plass 2",
                "postal_code": "0185"
              },
              "access_controlled_venue": true,
              "affiliate_name": "Klarna affiliate"
            }
          ],
          "subscription": {
            "subscription": {
              "subscription_name": "Contact lenses",
              "start_time": "2023-08-16T15:00:00Z",
              "end_time": "2023-09-16T15:00:00Z",
              "auto_renewal_of_subscription": true,
              "affiliate_name": "Klarna affiliate"
            },
            "customer_account_info": {
              "unique_account_identifier": "Adam Adamsson",
              "account_registration_date": "2023-08-16T15:00:00Z",
              "account_last_modified": "2023-10-16T15:00:00Z"
            }
          },
          "travel": {
            "air_reservation_details": {
              "itinerary": [
                {
                  "departure": "OSL",
                  "arrival": "MUC",
                  "carrier": "LH",
                  "departure_date": "2023-08-16T15:00:00Z",
                  "ticket_delivery_method": "phone",
                  "ticket_delivery_recipient": "97712123",
                  "departure_city": "Oslo",
                  "arrival_city": "Munich",
                  "segment_price": 200000,
                  "passenger_id": [
                    1
                  ],
                  "class": "First Class"
                }
              ],
              "pnr": "VH67899",
              "insurance": [
                {
                  "insurance_company": "Oopsie Insurance Ltd.",
                  "insurance_type": "travel",
                  "insurance_price": 50000
                }
              ],
              "passengers": [
                {
                  "first_name": "Paul",
                  "last_name": "Lamb",
                  "id": 1,
                  "title": "mr"
                }
              ],
              "affiliate_name": "Klarna affiliate"
            },
            "bus_reservation_details": {
              "itinerary": [
                {
                  "departure_city": "Oslo",
                  "arrival_city": "Munich",
                  "carrier": "Big Bus Travels Ltd.",
                  "departure_date": "2023-08-16T15:00:00Z",
                  "ticket_delivery_method": "phone",
                  "ticket_delivery_recipient": "97712123",
                  "segment_price": 200000,
                  "passenger_id": [
                    1
                  ],
                  "class": "First Class"
                }
              ],
              "pnr": "VH67899",
              "insurance": [
                {
                  "insurance_company": "Oopsie Insurance Ltd.",
                  "insurance_type": "travel",
                  "insurance_price": 50000
                }
              ],
              "passengers": [
                {
                  "first_name": "Paul",
                  "last_name": "Lamb",
                  "id": 1,
                  "title": "mr"
                }
              ],
              "affiliate_name": "Klarna affiliate"
            },
            "train_reservation_details": {
              "itinerary": [
                {
                  "departure_city": "Oslo",
                  "arrival_city": "Munich",
                  "carrier": "Big Train Travels Ltd.",
                  "departure_date": "2023-08-16T15:00:00Z",
                  "ticket_delivery_method": "phone",
                  "ticket_delivery_recipient": "97712123",
                  "passenger_id": [
                    1
                  ],
                  "segment_price": 200000,
                  "class": "First Class"
                }
              ],
              "pnr": "VH67899",
              "insurance": [
                {
                  "insurance_company": "Oopsie Insurance Ltd.",
                  "insurance_type": "travel",
                  "insurance_price": 50000
                }
              ],
              "passengers": [
                {
                  "first_name": "Paul",
                  "last_name": "Lamb",
                  "id": 1,
                  "title": "mr"
                }
              ],
              "affiliate_name": "Klarna affiliate"
            },
            "ferry_reservation_details": {
              "itinerary": [
                {
                  "departure_city": "Oslo",
                  "arrival_city": "Munich",
                  "carrier": "Big Ferry Travels Ltd.",
                  "departure_date": "2023-08-16T15:00:00Z",
                  "ticket_delivery_method": "phone",
                  "ticket_delivery_recipient": "97712123",
                  "segment_price": 200000,
                  "passenger_id": [
                    1
                  ],
                  "class": "First Class"
                }
              ],
              "pnr": "VH67899",
              "insurance": [
                {
                  "insurance_company": "Oopsie Insurance Ltd.",
                  "insurance_type": "travel",
                  "insurance_price": 50000
                }
              ],
              "passengers": [
                {
                  "first_name": "Paul",
                  "last_name": "Lamb",
                  "id": 1,
                  "title": "mr"
                }
              ],
              "affiliate_name": "Klarna affiliate"
            },
            "hotel_reservation_details": {
              "itinerary": [
                {
                  "start_time": "2023-08-16T15:00:00Z",
                  "end_time": "2023-08-20T15:00:00Z",
                  "number_of_rooms": 2,
                  "passenger_id": [
                    1
                  ],
                  "ticket_delivery_method": "phone",
                  "ticket_delivery_recipient": "97712123",
                  "hotel_price": 200000,
                  "hotel_name": "Premium Hotel",
                  "address": {
                    "city": "Oslo",
                    "country": "NO",
                    "street_address": "Karl Johans gt. 31",
                    "postal_code": "0159"
                  },
                  "class": "First Class"
                }
              ],
              "pnr": "VH67899",
              "insurance": [
                {
                  "insurance_company": "Oopsie Insurance Ltd.",
                  "insurance_type": "travel",
                  "insurance_price": 50000
                }
              ],
              "passengers": [
                {
                  "first_name": "Paul",
                  "last_name": "Lamb",
                  "id": 1,
                  "title": "mr"
                }
              ],
              "affiliate_name": "Klarna affiliate"
            },
            "car_rental_reservation_details": {
              "itinerary": [
                {
                  "rental_company": "Premium Cars",
                  "start_time": "2023-08-16T15:00:00Z",
                  "end_time": "2023-08-20T15:00:00Z",
                  "drivers_id": [
                    1
                  ],
                  "pick_up_location": {
                    "city": "Oslo",
                    "country": "NO",
                    "street_address": "Karl Johans gt. 31",
                    "postal_code": "0159"
                  },
                  "drop_off_location": {
                    "city": "Oslo",
                    "country": "NO",
                    "street_address": "Karl Johans gt. 31",
                    "postal_code": "0159"
                  },
                  "car_price": 500000,
                  "class": "Premium Cars Premium Class"
                }
              ],
              "drivers": [
                {
                  "first_name": "Paul",
                  "last_name": "Lamb",
                  "id": 1,
                  "title": "mr"
                }
              ],
              "pnr": "VH67899",
              "insurance": [
                {
                  "insurance_company": "Oopsie Insurance Ltd.",
                  "insurance_type": "travel",
                  "insurance_price": 50000
                }
              ],
              "affiliate_name": "Klarna affiliate"
            }
          },
          "marketplace_order": {
            "seller_info": {
              "sub_merchant_id": "Marketbrick Ltd.",
              "product_category": "Phones",
              "account_registration_date": "2023-08-16T15:00:00Z",
              "account_last_modified": {
                "password": "2023-08-17T15:00:00Z",
                "email": "2023-08-17T15:00:00Z",
                "listing": "2023-08-17T15:00:00Z",
                "login": "2023-08-17T15:00:00Z",
                "address": "2023-08-17T15:00:00Z"
              },
              "number_of_trades": 23,
              "unique_account_identifier_seller": {
                "email": "<string>",
                "phone_number": "97712123",
                "other": "<string>"
              },
              "product_name": "iPhone 14 Pro Max",
              "seller_rating": 5,
              "volume_of_trades": 230
            },
            "winner_info": {
              "account_registration_date": "2023-08-16T15:00:00Z",
              "account_last_modified": {
                "password": "2023-08-17T15:00:00Z",
                "email": "2023-08-17T15:00:00Z",
                "listing": "2023-08-17T15:00:00Z",
                "login": "2023-08-17T15:00:00Z",
                "address": "2023-08-17T15:00:00Z"
              },
              "number_of_trades": 23,
              "unique_account_identifier_winner": {
                "email": "<string>",
                "phone_number": "97712123",
                "other": "<string>"
              },
              "volume_of_trades": 230
            }
          }
        },
        "store": {
          "id": "sc029",
          "name": "SC Oslo",
          "business_name": "SC Oslo AS",
          "address": {
            "address_line": "Sommerkroveien 34",
            "postal_place": "Oslo",
            "country": "NO",
            "address_line_2": "PB 123",
            "postal_code": "0349"
          },
          "chain": "SuperChain",
          "email": "contact@superchain.com",
          "gln": "5790001398644",
          "organization_number": "123456789MVA",
          "phone_number": "+4738260107",
          "mcc": "5814",
          "bax": "102603",
          "terminal_id": "T0292",
          "payout_destination_id": "seller-1"
        },
        "eligible_for_discount": true,
        "is_changed": true,
        "gross_amount": 123,
        "discount_lines": [
          {
            "amount": 4400,
            "percentage": 44,
            "discount_type": "customer",
            "discount_id": "766da0ef-9283-42bd-b012-0582344ec53c",
            "description": "<string>",
            "line_id": 1
          }
        ]
      }
    ],
    "discount_codes": [
      "SUMMER20"
    ]
  }
}

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.

Body

application/json
​
url
object
required
​
order
object
required
​
configuration
object
required
​
id
string

The ID of the Checkout

​
created_at
string<date-time>

Time when the Checkout was created

​
customer
object
​
expires_at
string<date-time>

The session expiration time after which the Checkout page wouldn't be available

​
checkboxes
object[]

Configuration for checkboxes that should be part of the checkout

Maximum array length: 2
​
express
object

Present only for Express Checkout sessions.

An Express Checkout session is a session where the end user will submit a shipping address and then select a shipping option before the before a payment method is selected and the payment is initiated.

Endpoints used in the Express Checkout flow.

  1. Set shipping address
  2. Set shipping option
​
updated_at
string<date-time>

Last time when the Checkout was updated

​
customer_ip
string

The IP of the customer upon visiting the page. If the page is visited multiple times, the field is always updated with the last known value.

​
user_agent
string

The full user agent of the device the customer used when visiting the checkout page

​
initiating_system_request_headers
object
​
payment_operation
enum<string>

Initiated by the merchant or used to generate a token

Available options:
unscheduled_purchase,
recurring_purchase,
generate_payment_token
​
events
object[]

Checkout process events

Example:
[
  {
    "id": "769952fe-86c9-4185-a1ce-aeb46da3509c",
    "name": "INITIATED",
    "created_at": "2019-05-09T09:13:40.306Z",
    "request_id": "b97b6312-f8b3-11ed-be56-0242ac120002"
  },
  {
    "name": "VISITED",
    "created_at": "2019-05-09T09:13:50.548Z"
  },
  {
    "name": "PAY_FAILED",
    "created_at": "2019-05-09T09:14:10.548Z",
    "details": {
      "error": "Rejected",
      "payment_product_type": "instabank.finance"
    }
  },
  {
    "name": "FAILED",
    "created_at": "2019-05-09T09:16:11.786Z"
  }
]
​
transaction_id
string

Transaction which has been created using the checkout.

​
metadata
object

metadata about the session

Response

200 - application/json

Session shipping options update

​
shipping_options
object[]
required

Shipping options that will be presented to the end user after the callback

  • If the merchant is not able to ship the order to the end users shipping address, use an empty array.
  • If there is only one option, a free delivery, the order still has to contain one option with a price.amount of 0.
​
order
object

Updates to session order. If the amount is not equal to sum of items.amount and the shipping_option.amount from the request are not equal a correction item will be added to the items.