Callback URIs


At certain points in an order's lifetime we will attempt to call endpoints on your side. You provide the URI:s for these endpoints in the MerchantSettings object when you call CreateOrder.

Make sure that your server accepts calls to these URIs and that your firewall whitelists connections from our IP-range: 193.13.207/24.

Name Description Type Additional Information
CheckoutValidationCallBackUri An optional URI to a location that is expecting callbacks from the Checkout to validate order’s stock status and also the possibility to update checkout with an updated ClientOrderNumber.

May contain a {checkout.order.uri} placeholder which will be replaced with the checkoutorderid.

Requests for this endpoint are made with HTTP Method GET.

Your response's HTTP Status Code is interpreted as:
  • 200-299 is interpreted as validation passed.
  • Everything else is interpreted as validation failure.
See CheckoutValidationCallbackResponse for a description of the expected response content.
String Data type: Url. Max length: 500.
PushUri URI to a location that is expecting callbacks from the Checkout whenever an order’s state is changed (confirmed, final, etc.).

May contain a {checkout.order.uri} placeholder which will be replaced with the checkoutorderid.

Requests for this endpoint are made with HTTP Method POST.

Your response's HTTP Status Code is interpreted as:
  • 100-199 are ignored.
  • 200-299 is interpreted as OK.
  • 300-399 are ignored.
  • 404 - the order hasn't been created on your side yet. We will try pushing again. All other 400 status codes are ignored.
  • 500 and above is interpreted as error on your side. We will try pushing again.
String Required. Data type: Url. Max length: 500. Min length: 1.
TermsUri URI to a page with webshop specific terms. String Required. Data type: Url. Max length: 500. Min length: 1.
CheckoutUri URI to the page in the webshop displaying the Checkout. May not contain order specific information. String Required. Data type: Url. Max length: 500. Min length: 1.
ConfirmationUri URI to the page in the webshop displaying specific information to a customer after the order has been confirmed. May not contain order specific information. String Required. Data type: Url. Max length: 500. Min length: 1.
ActivePartPaymentCampaigns List of valid CampaignIDs. If used then list of available part payment campaign options will be filtered through the chosen list. Collection of Int64 Must be a list of valid CampaignIDs.
PromotedPartPaymentCampaign Valid CampaignID. If used then the chosen campaign will be shown as the first payment method in all payment method lists. Int64 Must be valid CampaignID.