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. Some URIs, for example localhost and svea.com, are blocked and no callback will be made.

Name Description Type Additional Information
CheckoutValidationCallBackUri An optional URI to a location that expects callbacks from the Checkout to validate an order’s stock status It also has the possibility to update the 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 expects 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, a 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 If used, the chosen campaign will be listed first in all payment method lists. Int64 Must be valid CampaignID.