v1

latestOpenAPI 3.1.02026-07-24170121.2 MB

Transactions

Void

This API endpoint allows you to send a void command to the terminal for a previously submitted sale. The final outcome is delivered asynchronously to the callbackURL.

post/v3/transactions/void

Headers

Authorizationstring required

Bearer token used to authenticate API requests.

X-Idempotency-Keystring uuid required

Unique key used to prevent duplicate transaction commands.

Request body

tenantIdstring required

The last 12 digits of the merchant identifier (MID).

terminalIdstring required

10-digit terminal serial number.

transactionIdstring required

Client-generated transaction identifier used for reconciliation.

originalTransactionIdstring required

Original sale transaction identifier being voided.

tenderType'CREDIT' | 'DEBIT' required

Tender type used on the original transaction.

reasonstring nullable

Reason for the void request.

printReceipt0 | 1 | 2 | 3 required

Allowed values: <br> 0 – No receipt<br> 1 – Print merchant receipt<br> 2 – Print customer receipt<br> 3 – Print both merchant and customer receipts

callbackURLstring required

HTTPS endpoint that receives the asynchronous callback payload.

metadataobject

Optional key-value metadata used for correlation and diagnostics.

Example request

{
  "tenantId": "000123400010",
  "terminalId": "0099999999",
  "transactionId": "3fa85f645717",
  "originalTransactionId": "1234456xdf",
  "callbackURL": "https://example.com/payarc/callback"
}

Response

Transaction Initiated

traceIdstring uuid

Correlation identifier matching the initial API response traceId

Example response

{
  "response": {
    "status": "SUCCESS"
  }
}