Skip to main content

Voiding Transactions

A void is the cancellation of a transaction before the acquirer's batch cutover time. Voiding a transaction prevents the funds from being captured from the cardholder's account.

Void Eligibility​

To determine if a transaction can be voided:

  • Check the voidableUntilTime field in the Transaction Webhook.
  • This timestamp indicates the cutover deadline for voiding the transaction.
  • After this time, a refund must be used instead.

Processing a Void​

To void a transaction, use the transaction ID from the webhook as the identifier in your void request.

Minimum Required Payload​

{
  "terminal": {
    "serialNumber": "{{serial_number}}",
    "batteryPercent": 50
  },
  "posData": {
    "reason": "Double scanned item"
  },
  "sendDateTime": "{{send_date_time}}"
}

Key Fields Explained​

  • terminal.serialNumber: The identifier of the terminal that processed the original transaction
  • posData.reason: A description of why the transaction is being voided (for record-keeping)
  • sendDateTime: The timestamp when the void request is sent

After Voiding​

Once a void has been approved:

  • The transaction is considered canceled.
  • No additional voids can be performed.
  • No refunds can be processed against this transaction.