post https://pay2new.in/apis/aeps/v1/balanceCheck (COPY)
Header Request
Accept : application/json
Content-Type: application/json
secret : Unique secret key (Provided by Pay2New)
outletId: Unique OutletID (Provided by Pay2New)
Request Parameters
| biometricData.Parameters | Type | Mandatory (M) , Optional (O) | Description |
|---|---|---|---|
| bankiin | String | M | Unique bank identification number (You will get it from a list of banks API) |
| latitude | String | M | Current location latitude |
| longitude | String | M | Current location longitude |
| customer_mobile | String | M | User Mobile no (Bank Account User) |
| request_id | String | M | Unique Reference number |
| product_code | String | M | Unique Operator Code |
| ip | String | M | Onboard User IP Address |
| biometricData | Array | M | Biometric data details |
| biometricData.dc | String | M | Returned by RD Service when using biometric authentication. Registered Device code. |
| biometricData.ci | String | M | Returned by RD Service when using biometric authentication. Public key certificate identifier of UIDAI using which skey was encrypted. |
| biometricData.hmac | String | M | Returned by RD Service when using biometric authentication. SHA -256 Hash of PID XML and then encrypted and base 64 encoded. |
| biometricData.dpId | String | M | Returned by RD Service when using biometric authentication. Device provider Id. |
| biometricData.mc | String | M | Returned by RD Service when using biometric authentication. encrypted registered device public key certificate. |
| biometricData.pidDataType | String | M | Returned by RD Service when using biometric authentication. Protobuff format or XML format. |
| biometricData.sessionKey | String | M | Returned by RD Service when using biometric authentication. AES session key is generated dynamically for every txn. |
| biometricData.mi | String | M | Returned by RD Service when using biometric authentication. RD model Id. |
| biometricData.rdsId | String | M | Returned by RD Service when using biometric authentication. RD Service Id. |
| biometricData.errCode | String | O | 0(Default)- Request Success |
| biometricData.errInfo | String | O | Information about the error |
| biometricData.fCount | String | O | Total number of FIR records which was part of input. |
| biometricData.fType | String | M | When connecting the Device to RD service send ftype 2 in the request. |
| biometricData.iCount | String | O | Total number of IIR records which was part of input. |
| biometricData.iType | String | O | ISO format (0 for IIR), 0 (IIR) is the default. |
| biometricData.pCount | String | O | A number of face photo records are to be captured (0 to 1). |
| biometricData.pType | String | M | Face format |
| biometricData.srno | String | M | Serial Number of the biometric device. |
| biometricData.pidData | String | M | Returned by RD Service when using biometric authentication. |
| biometricData.qScore | String | M | If a quality check is done, send a normalized score that is between 0 and 100. Device providers may allow configuration within RD service to use specific quality check algorithms to be enabled. |
| biometricData.nmPoints | String | M | Number of minutiae points when FMR is captured. Applications may use this for accepting or retrying the capture. |
| biometricData.rdsVer | String | M | Returned by RD Service when using biometric authentication. RD Service version. |
| biometricData.aadhaar_number | String | M | Customer Aadhaar Number |
Sample Request
curl --location 'https://pay2new.in/apis/aeps/v1/balanceCheck' \
--header 'secret: Provided by Pay2New' \
--header 'outletId: Provided by Pay2New' \
--header 'Content-Type: application/json' \
--data '{
"bankiin": "6***14",
"latitude": "19.2123",
"longitude": "75.5723",
"customer_mobile": "9876543210",
"request_id": "P2N54544444545",
"product_code": "242,
"ip": "30.169.159.167",
"biometricData": {
"dc": "ncSXJORuYJy8kE71-ncSXJORuYJy8kE71-ncSXJORuYJy8kE71-ncSXJORuYJy8kE71",
"ci": "20250923",
"hmac": "MwM2dgIVncSXJORuYJy8kE71419FF4D2CE9CDMwM2dgIV",
"dpId": "MANTRA.MSIPL",
"mc": "ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71",
"pidDataType": "X",
"sessionKey": "ncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71",
"mi": "MFS100",
"rdsId": "MANTRA.AND.001",
"errCode": "0",
"errInfo": "Capture Success",
"fCount": "1",
"fType": "2",
"iCount": "0",
"iType": "0",
"pCount": "0",
"pType": "0",
"srno": "5194**7",
"pidData": "ncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CD",
"qScore": "73",
"nmPoints": "42",
"rdsVer": "1.0.8",
"aadhaar_number": "123456789123"
}
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://pay2new.in/apis/aeps/v1/balanceCheck',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"bankiin": "6***14",
"latitude": "19.***3",
"longitude": "75.***3",
"customer_mobile": "********55",
"request_id": "123456789",
"product_code": "241",
"ip": "88.88.230.88",
"biometricData": {
"dc": "ncSXJORuYJy8kE71-ncSXJORuYJy8kE71-ncSXJORuYJy8kE71-ncSXJORuYJy8kE71",
"ci": "20250923",
"hmac": "MwM2dgIVncSXJORuYJy8kE71419FF4D2CE9CDMwM2dgIV",
"dpId": "MANTRA.MSIPL",
"mc": "ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71ncSXJORuYJy8kE71",
"pidDataType": "X",
"sessionKey": "ncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71",
"mi": "MFS100",
"rdsId": "MANTRA.AND.001",
"errCode": "0",
"errInfo": "Capture Success",
"fCount": "1",
"fType": "2",
"iCount": "0",
"iType": "0",
"pCount": "0",
"pType": "0",
"srno": "5194**7",
"pidData": "ncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CDncSXJORuYJy8kE71419FF4D2CE9CD",
"qScore": "73",
"nmPoints": "42",
"rdsVer": "1.0.8",
"aadhaar_number": "123456789123"
}
}',
CURLOPT_HTTPHEADER => array(
'secret: Provided by Pay2New',
'outletId: Provided by Pay2New',
'Content-Type: application/json'
'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Response Parameters
| Name | Type | Description |
|---|---|---|
| status | Integer | Pay2New Transaction Status |
| message | String | Message from API |
| order_id | Array | Response Data (If Present) |
| txn_value | String | Transaction Amount |
| balance | String | API Account balance |
| request_id | String | Your Unique Transaction Id |
| bank_reference | String | Bank Ref Number |
| statement | Array | Bank Mini Statement data |
| account_balance | String | Customer Bank account balance |
| bank_name | String | Customer Bank Name |
Sample Response
{
"status": 1,
"message": "Transaction Successful",
"order_id": "P2N5452534158DFOLASDF",
"txn_value": "0.00",
"balance": 15152.95,
"request_id": "P2N54544444545",
"bank_reference": "1234567890123",
"statement": [
{
"date": "05\/03",
"txnType": "DR",
"amount": "3610.00",
"narration": "PH305030931617959"
},
{
"date": "04\/30",
"txnType": "CR",
"amount": "4.00",
"narration": "7066058**0C230430"
},
{
"date": "04\/24",
"txnType": "CR",
"amount": "1400.00",
"narration": "PH3042***3080093"
},
{
"date": "04\/24",
"txnType": "CR",
"amount": "100.00",
"narration": "PH304****3070379"
},
{
"date": "04\/13",
"txnType": "CR",
"amount": "2300.00",
"narration": "P*****30908543347"
},
{
"date": "04\/13",
"txnType": "CR",
"amount": "100.00",
"narration": "PH3041309****2301"
},
{
"date": "04\/01",
"txnType": "DR",
"amount": "17.00",
"narration": "PH304011****99668"
},
{
"date": "04\/01",
"txnType": "CR",
"amount": "5.00",
"narration": "PH3040***73488400"
},
{
"date": "03\/31",
"txnType": "DR",
"amount": "15.00",
"narration": "PH303****4293753"
}
],
"account_balance": "25299.00",
"bank_name": "AIRTEL PAYMENTS BANK"
}
Please Note:
To avoid transaction failures and account suspension, for every merchant you need to pass the unique outlet Id in the headers.