Skip to main content

Upsell an order

Use this request to increase the amount of an order before it has been shipped to the customer

Use case​

The customer contacted you prior to shipping the order and wants to add an item that they missed or wanted to add to the order.

In some cases the change might be rejected because we cannot extend the original order amount due to lack of space for reserved credit amount.

Note that...

Prepaid options are currently not supported.

Endpoints used​

Reauthorize order with increased amount


The following request will update the order with id abcdef-12345-1234-5555-6666.

Note that...

Providing the items is optional, but it will be clearer to the customer so we recommend that you always include them if possible. Reauthorizing only by amount will result in the rows not being showed.

In this example, the order is reauthorized with an additional quantity of 1 on the article 10001 which increases the orders amount with 95.

POST /manage/orders/abcdef-12345-1234-5555-6666/reauthorize HTTP/1.1
Host: // (Please note! Different hostname in production)
Authorization: Bearer bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...
X-idempotency: 03304b06-cb33-4f78-bcea-86cb4b202ba0

//Upsell on an order with original order amount: 285.0

"amount": 380.0,
"actionReference": "this-will-be-shown-on-reconciliation-reports",
"items": [
"id": "10001",
"description": "Shoes",
"unitPrice": 95,
"quantity": 2
"id": "10002",
"description": "T-Shirt",
"unitPrice": 95,
"quantity": 2