In-Store Payments

Void

The Void operation allows you to reverse a previously approved authorization, sale, or refund transaction. This operation relates to a previous credit card transaction. Voids are only possible if the original transaction is in the open batch on the same terminal.

Attention

Void is not supported for United States or Canada debit. It is only supported for credit card transactions.
If void is not supported for your use case, proceed with a refund.
Refunds to Interac (Canada's debit network) require the card to be present.

Properties

The following table lists the properties of a void operation:

Properties of a void operation
Item	Description
Operation name displayed on a terminal	Void
Operation name displayed on a receipt	`VOID`
Merchant is requested to supply the following data	Original authorization code
Cardholder is requested to supply the following data	None
ISO transaction message	1400
Can the operation be autoreversed?	No
Does the operation use data supplied by the cardholder?	Yes
Merchant copy of the receipt?	Yes
Cardholder copy of the receipt?	Yes
Is the receipt stored as “last receipt”?	Yes
Can the receipt have a signature line?	No

Request fields

The following table lists and defines Void request fields:

Request fields for void
Field	Description	Presence
`operation`	Contains the value `Transaction`.	Mandatory
`type`	The transaction type.	Mandatory
`originalAuthCode`	The authorization code returned in the original authorization. This field is alphanumeric.	Mandatory
`tipAmount`	If tipAmount is provided, the Payment Terminal Application does not prompt for tip during the transaction flow.	Optional
`uniqueTransactionId`	Unique reference provided by the point-of-sale (POS) application or a 30-character unique ID generated by the Payment Terminal Application. The first 22 characters (left justified) are used for reporting. This field is alphanumeric.	Optional
`printReceipt`	Applies to receipts printed by the payment terminal device or a printer attached to it. If you omit `printReceipt`, the default value is `0` and no receipt is printed. Value: `0` = Do not print receipt `1` = Print receipt (if supported)	Optional

Example

The following is an example of a request to process a void:

Json

{
  "operation": "Transaction",
  "type": "VOID",
  "originalAuthCode": "411922"
}

The following is an example of a Void response:

Json

{
  "account": "222360******0329",
  "approval": "approved",
  "authCode": "411922",
  "authorizedAmount": "2020",
  "batchJulianDay": "25092",
  "batchNumber": "000001",
  "cardBrand": "MASTERCARD",
  "cardToken": "2223603006060329",
  "cardTypeProcessed": "1",
  "cardholderReceipt": "\n\n\nMerc. ID: 9999999\nTerm. ID: 009\nRRN: 000000023922\nTax Number: 0\nFri,Apr 04,2025         02:40:12\n\n              VOID\n\n            APPROVED\n\n      No Signature Required\n\n      ****************0329\nMASTERCARD           Contactless\n\nAMOUNT                    $20.20\nSUBTOTAL                  $20.20\n            ____________________\nTOTAL                     $20.20\n\nTran ID:0920000011000010\nBatch#: 092-001\nApproval Code: 411922\nAID: A0000000041010\n\n          Customer copy\n            Thank You\n        Please Come Again\n",
  "currencyCode": "USD",
  "dateTime": "04-04-2025 02:40:12",
  "demoMode": "no",
  "entryMode": "Contactless",
  "expDate": "2512",
  "footerLine1": "Thank You",
  "footerLine2": "Please Come Again",
  "merchantID": "9999999",
  "merchantReceipt": "\n\n\nMerc. ID: 9999999\nTerm. ID: 009\nRRN: 000000023922\nTax Number: 0\nFri,Apr 04,2025         02:40:12\n\n              VOID\n\n            APPROVED\n\n      No Signature Required\n\n      ****************0329\nMASTERCARD           Contactless\n\nAMOUNT                    $20.20\nSUBTOTAL                  $20.20\n            ____________________\nTOTAL                     $20.20\n\nTran ID:0920000011000010\nBatch#: 092-001\nApproval Code: 411922\nAID: A0000000041010\n\n          Merchant copy\n            Thank You\n        Please Come Again\n",
  "operation": "Transaction",
  "reference": "000000023922",
  "requestedAmount": "2020",
  "responseCode": "00",
  "result": "0",
  "shift": "0",
  "table": "0",
  "taxAmount": "0",
  "terminalID": "009",
  "totalAmount": "2020",
  "transactionID": "0920000011000010",
  "transactionType": "VOID",
  "type": "VOID",
  "uniqueTransactionId": "700000014312009174370921200000"
}