In-Store Payments

Balance Inquiry

The Balance Inquiry operation allows a consumer to check the available funds for their account.

This operation is performed online.

Properties

The following table lists the properties of a Balance Inquiry operation.

Properties of a balance inquiry operation
Item	Description
Operation name displayed on a terminal	Balance Inquiry
Operation name displayed on a receipt	`BALANCE INQUIRY`
Cardholder is requested to supply the following data	Card, EMV Application Selection, PIN
ISO transaction message	1100
Can the operation be autoreversed?	No
Does the operation use data supplied by the cardholder?	Yes
Merchant copy of the receipt?	No
Cardholder copy of the receipt?	Yes
Is the receipt stored as “last receipt”?	No
Can the receipt have a signature line?	No

Request fields

The following table lists and defines the Balance Inquiry request fields:

Request fields for balance inquiry
Field	Description	Presence
`operation`	Contains the value `Transaction`.	Mandatory
`type`	The transaction type.	Mandatory
`reference`	A point-of-sale (POS)-generated reference number. Maximum of 12 alphanumeric characters. If no value is supplied, a value will be generated by our payment host. If this field is used, it must be unique per batch. This value is inserted into the Retrieval Reference Number (RRN) field of the transaction response receipt data.	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 example is a request to process a balance inquiry:

Json

{
  "operation": "Transaction",
  "type": "BALANCE_INQUIRY"
}

The following example is a Balance Inquiry response:

Json

{
  "AC": "",
  "ARC": "",
  "IAD": "",
  "PARData": "CN75Z28RKA1EBL470G9XYG90R5D3E",
  "TSI": "",
  "account": "401136******0012",
  "approval": "approved",
  "authCode": "098562",
  "balance": "500",
  "batchJulianDay": "25092",
  "batchNumber": "000001",
  "cardBrand": "VISA",
  "cardholderName": "XXXXXX/CHASENET TEST",
  "cardholderReceipt": "\n\n\nMerc. ID: 9999999\nTerm. ID: 009\nRRN: 000000025856\nTax Number: 0\nFri,Apr 04,2025         02:58:56\n\n         BALANCE INQUIRY\n\n      ****************0012\nVISA                      Swiped\n\nAMOUNT                     $0.00\nSUBTOTAL                   $0.00\n            ____________________\nTOTAL                      $0.00\n\nBalance Credit Card: 5.00\n\n\nTran ID:0920000012000005\nBatch#: 092-001\nApproval Code: 098562\n\n          Customer copy\n            Thank You\n        Please Come Again\n",
  "currencyCode": "USD",
  "cvm": "Signature",
  "dateTime": "04-04-2025 02:58:56",
  "demoMode": "no",
  "entryMode": "Swiped",
  "footerLine1": "Thank You",
  "footerLine2": "Please Come Again",
  "hostError": "00000",
  "merchantID": "9999999",
  "merchantReceipt": "\n\n\nMerc. ID: 9999999\nTerm. ID: 009\nRRN: 000000025856\nTax Number: 0\nFri,Apr 04,2025         02:58:56\n\n         BALANCE INQUIRY\n\n      ****************0012\nVISA                      Swiped\n\nAMOUNT                     $0.00\nSUBTOTAL                   $0.00\n            ____________________\nTOTAL                      $0.00\n\nTran ID:0920000012000005\nBatch#: 092-001\nApproval Code: 098562\n\n\nX  ______________________________\nXXXXXX/CHASENET TEST\n\n          Merchant copy\n            Thank You\n        Please Come Again\n",
  "operation": "Transaction",
  "reference": "000000025856",
  "requestedAmount": "0",
  "responseCode": "00",
  "result": "0",
  "shift": "0",
  "table": "0",
  "terminalID": "009",
  "transactionID": "0920000012000005",
  "transactionType": "BALANCE INQUIRY",
  "type": "BALANCE_INQUIRY"
}