/orders/{orderId}/void

Sandbox (Testing): https://gateway.sand.us.zip.co/orders/{orderId}/void

Voids uncaptured funds for the specified order and allocates them to the payment plan to apply it to the customer. Only applicable to pay-on-ship/deferred fund capture merchants. If sync query parameter is set to true, replies synchronously with callback payload, otherwise, replies asynchronously on callback URL. Default sync value is false for asynchronous behavior.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Important Notes

Example — "Success: True" Response

{
    “Amount”: 1.0, 
    “Currency”: “USD”,
    “MerchantId”: “c6194164-f330-4505-acd1-3e38e8615175”,
    “MerchantReference”: “VO”,
    “Operation”: “VoidOrder”,
    “OrderId”: “c1a083ae-e603-460c-8a0e-70d6e854cf77”, 
    “Success”: True,
    “Test”: False,
    “Timestamp”: “2022-02-25T15:00:43.8391167Z”
}

Example — "Success: False" Response

The amount to be voided must be less than or equal to the amount left to void, or a "Success: False" message will be given.

{	
    “Amount”: 300, 
    “Currency”: “USD”,
    “MerchantId”: “c6194164-f330-4505-acd1-3e38e8615175”,
    “MerchantReference”: “V”,
    “Operation”: “VoidOrder”,
    “Message”: Amount to be voided ($300.0) is greater than $20.05 available for void."
    “OrderId”: “c1a083ae-e603-460c-8a0e-70d6e854cf77”, 
    “Success”: False,
    “Test”: False,
    “Timestamp”: “2022-02-25T15:00:43.8391167Z”
}
Path Params
string
required
Query Params
boolean
Body Params
string
required

Gets or sets the MerchantId

string
required

Gets or sets the Currency of the capture

double
required

Gets or sets the Amount of the capture

string
required

Gets or sets the Merchant Reference of the capture

string

Gets or sets the url to callback with the void result

boolean

Gets or sets a value indicating whether this is a test order

boolean

Get or sets a flag indicating whether or not to invoke this operation synchronously. Set to false by default.

boolean

Gets or sets a flag indicating whether or not the command amount is set and not defaulted. By default, the void amount is included in the command.

Headers
string
required

Territory of the request (US)

string
required

The signature for merchant validation

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json