The Batch Inquiry Request is a request made to the Nilon gateway to retrieve the details of previously processed batches. A batch refers to a collection of transactions that have been grouped together for settlement purposes. When transactions are processed through the payment gateway, they are typically grouped into batches and sent for settlement to the acquiring bank.
By making a Batch Inquiry Request, merchants can obtain valuable information about their transaction history, reconcile their records with the settled batches, and ensure accurate financial reporting. This helps in monitoring and tracking the status of transactions, identifying any discrepancies or errors, and maintaining proper financial records.
The Batch Inquiry Request is typically made through an API or integration with the Nilon gateway, where the necessary parameters are provided to retrieve the desired batch details. The response from the gateway includes the requested batch information, which can then be processed or displayed as per the merchant's requirements.
Request Field Description:
| KEY | VALUE | DESCRIPTION |
|---|---|---|
Batch_Idnumeric | auto generated | Batch ID of the settled transaction is required to view details by id |
Response Field Description:
| KEY | VALUE | DESCRIPTION |
|---|---|---|
result_codestring | 1 – Approved 2- Declined 3- Error | The overall status of the transaction |
result_sub_codestring | 000- Approval | Response sub code |
result_textstring | upto 100 characters APPROVAL DECLINED | Description of the outcome of the transaction from First Data |
terminal_numberstring | upto 100 characters | ID of terminal used |
terminal_namestring | upto 100 characters | Name of the terminal used |
batch_idstring | auto generated | ID of the batch generated |
batch_datestring | Format- yyyyMMddTHHmmssZ | Date of batch processing |
| Transaction | ||
gateway_idnumeric | ID of Gateway used | ID of the gateway used for processing transaction |
terminal_idnumeric | ID of Terminal | ID of the terminal from where transaction was processed |
merchant_terminal_idnumeric | Merchant ID | ID provided to the merchant for processing transaction |
transaction_idstring | upto 6 digits | Gateway assigned transaction ID for the request. |
transaction_datetimestring | Format- yyyyMMddTHHmmssZ | Date and Time of the transaction response |
accountnumberlast4string | Last 4 card digits | Displays the last 4 digits of the card used for transaction. |
expiration_datestring | MMYY | The card’s expiration date |
transaction_amountnumeric | Upto 2 Decimal Places | Transaction amount requested in original authorization. |
methodstring | CC- Credit card ACH- Automated Clearing House EBT- Electronic Benefit Transfer DB- Debit Card | The method used to perform the transaction is provided here. |
auth_idalphanumeric | auto generated | Unique code is generated by the Processor to identify the transaction |
transaction_typenumeric | 1- AuthOnly 2- AuthCapture 3- Prior_Auth_Capture 4- Capture_Only 5- Void 6- Partial_Void 7- Credit 9- Verification 10 – Update 11- BalanceInquiry | Type of transaction performed is returned in this field. |
noncestring | value- max 50 characters | The nonce value is sent back in the response, the significance is to indicate that the transaction is unique |
tokenstring | alphanumeric value generate by token generation process | Token details from token table |