Void an Order

Plugin icon

Void an Order

Only for pay-on-ship/DFC merchants. This voids funds to reflect a cancelled item in an order. Required fields are:

  • orderId - Zip order ID to void
  • merchantId - Your identifier provided by Zip
  • currency - The currency to issue the void in
  • amount - The amount of the void (not the amount of the order!)
  • merchantReference - An identifier in your system to reference this void transaction
  • callbackUrl - A URL that will receive the webhook request about the result of this operation

Example

Request URL: https://gateway.us.zip.co/orders/11111111-1111-1111-1111-111111111111/void
POST Body:

{
  "orderId": "11111111-1111-1111-1111-111111111111",
  "currency": "USD",
  "amount": 123.45,
  "merchantReference": "ref",
  "callbackUrl": "https://api.merchant.com"
}