The Batch Inquiry Request is a request made to the OnePay 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 OnePay 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:

KEYVALUEDESCRIPTION
Batch_Id
numeric
auto generatedBatch ID of the settled transaction is required to view details by id

Response Field Description:

KEYVALUEDESCRIPTION
result_code
string
1 – Approved
2- Declined
3- Error
The overall status of the transaction
result_sub_code
string
000- ApprovalResponse sub code
result_text
string
upto 100 characters
APPROVAL
DECLINED
Description of the outcome of the transaction from First Data
terminal_number
string
upto 100 charactersID of terminal used
terminal_name
string
upto 100 charactersName of the terminal used
batch_id
string
auto generatedID of the batch generated
batch_date
string
Format- yyyyMMddTHHmmssZDate of batch processing
Transaction
gateway_id
numeric
ID of Gateway usedID of the gateway used for processing transaction
terminal_id
numeric
ID of TerminalID of the terminal from where transaction was processed
merchant_terminal_id
numeric
Merchant IDID provided to the merchant for processing transaction
transaction_id
string
upto 6 digitsGateway assigned transaction ID for the request.
transaction_datetime
string
Format- yyyyMMddTHHmmssZDate and Time of the transaction response
accountnumberlast4
string
Last 4 card digitsDisplays the last 4 digits of the card used for transaction.
expiration_date
string
MMYYThe card’s expiration date
transaction_amount
numeric
Upto 2 Decimal PlacesTransaction amount requested in original authorization.
method
string
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_id
alphanumeric
auto generatedUnique code is generated by the Processor to identify the transaction
transaction_type
numeric
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.
nonce
string
value- max 50 charactersThe nonce value is sent back in the response, the significance is to indicate that the transaction is unique
token
string
alphanumeric value generate by token generation processToken details from token table
Language
Click Try It! to start a request and see the response here!