v1

latestOpenAPI 3.1.02026-07-24170121.2 MB
Cancel Transactions

Cancel

This API endpoint allows you to cancel a pending transaction prior to the card being submitted for processing. Once the card has begun processing, the transaction can no longer be cancelled via this API.

post/v3/transactions/{traceId}/cancel

Path parameters

traceIdstring uuid required

Unique trace identifier for the transaction

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.

Example request

{
  "tenantId": "145504363463",
  "terminalId": "1850401309"
}

Response

Transaction cancellation successful.

traceIdstring uuid

Correlation identifier matching the initial API response traceId

Example response

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