Skip to main content

Cancel Order

If orders items should no longer be delivered to the end customer. Use this endpoint to cancel all remaining order items that has not yet been captured.

Please note

This can only be done on orders with status NotActivated or PartActivated or Expired. This action is non-reversible.

Canceled order items should not be delivered to the customer and if it was a direct payment, the customer will be refunded the amount of the canceled rows.

POST /manage/orders/{{orderId}}/cancel HTTP/1.1
Host: // (Please note! Different hostname in production)
Authorization: Bearer bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...

/* Optional body */
"actionReference": "test-cancelref-123"
Http status codeDescription
202Order canceled
401Unauthorized, token verification needed. See: Authentication for more information
403Permissions needed e.g. trying to handle content for a store you don't have permission to
404Order not found

Data Model​


Request headers​
AuthorizationYesInstructions on how to generate the Bearer token value can be found here
Request body​
actionReferenceNoA reference to this specific cancelation.stringThis will be visible in the order events and searchable in the Merchant Hub.


The response will be 202 Accepted for a successful cancel.

Please note

Due to the asynchronous nature of an Accepted status answer, it can take a few seconds before the update can be shown in various systems and responses to API requests. You should design your system to accomodate this.