Skip to main content
POST
cURL
A void submits a cancellation against a previous pre-authorization. Identify both the originating transaction and its order in the request body. Use refund for a completed sale or capture.
Safe retries for this POST endpoint use the Idempotency-Key header. Reuse the same key only when retrying the exact same request body. See Idempotency.

Authorizations

x-api-key
string
header
required

Headers

idempotency-key
string

Optional idempotency key, scoped to terminal + matched route pattern. A replayed request returns the cached response with Idempotency-Replayed: true.

Maximum string length: 255
Pattern: ^[\w-]+$

Path Parameters

terminal_friendly_id
string
required

The unique identifier of the terminal.

Required string length: 6
Pattern: ^[\dA-Za-z]{6}$

Body

application/json
transaction_reference_id
string
required

The transaction friendly ID of the original transaction to be voided

Required string length: 8
Pattern: ^[\dA-Za-z]{8}$
order_reference_id
string
required

The order friendly ID associated with the original transaction to be voided

Required string length: 8
Pattern: ^[\dA-Za-z]{8}$

Response

Default Response

transaction_id
string
required
Required string length: 8
Pattern: ^[\dA-Za-z]{8}$
accepted
boolean
required
order_id
string
required
Required string length: 8
Pattern: ^[\dA-Za-z]{8}$
merchant_order_id
string