Skip to main content
POST
/
v1
/
orders
/
{request_id}
/
cancel
Initiate Cancellation
curl --request POST \
  --url https://api.zinc.io/v1/orders/{request_id}/cancel \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "merchant_order_id": "<string>",
  "webhooks": {
    "request_succeeded": "<string>",
    "request_failed": "<string>",
    "tracking_obtained": "<string>",
    "tracking_updated": "<string>",
    "status_updated": "<string>",
    "case_updated": "<string>"
  }
}'
{
  "request_id": "<string>"
}
The Zinc API supports pre-shipment order cancellation on Amazon.com and Amazon.co.uk.
You can only cancel an order after it has been successfully placed using the API
This is distinct from aborting an order, which occurs while the order is still in progress. Cancellations will send a cancellation request to the retailer and attempt to stop the order from shipping and can only be initiated for order requests that were successful.

Authorizations

​
Authorization
string
header
required

Use your client token as the username. Leave the password blank.

Path Parameters

​
request_id
string
required

The unique identifier for the order request to cancel

Body

application/json
​
merchant_order_id
string
required

The merchant order id of the order that you would like to cancel. If the order has multiple merchant_order_ids you must cancel each separately.

​
webhooks
object

A webhooks object including URLs that will receive POST requests after request_succeeded and request_failed

Response

200 - application/json

Cancellation initiated successfully

​
request_id
string

The unique identifier for the cancellation request

⌘I