post
https://pay2new.in/apis/upiAtm/v1/biometricKycStatus
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
1st Onboard customers using onboarding api then you receive outlet_id.
Header Request
Accept : application/json
Content-Type: application/json
secret : Unique secret key (Provided by Pay2New)
outletId: Unique OutletID (Provided by Pay2New)
Request Parameters
No request body is required. Send empty JSON.
Sample Request
curl -X POST "https://pay2new.in/apis/upiAtm/v1/biometricKycStatus" \
-H "Content-Type: application/json" \
-H "secret: YOUR_SECRET" \
-H "outletId: CUSTOMER_OUTLET_ID" \
-d '{}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://YOUR_DOMAIN/apis/upiAtm/v1/biometricKycStatus',
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 =>'{}',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'secret: YOUR_SECRET',
'outletId: CUSTOMER_OUTLET_ID'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Response Parameters
| Name | Type | Description |
|---|---|---|
| status | int | Pay2New Transaction Status |
| message | String | Message from API |
| data.customer_aadhaar_number | String | Customer mask Aadhaar number |
| data.status | String | KYC status |
| data.pidOptionWadh | String | KYC Wadh Value |
| data.referenceKey | String | KYC Reference Key |
| data.action | String | KYC action |
| order_id | String | Pay2New Order Id |
// Success response
{
"status": 1,
"message": "Transaction Successful",
"data": {
"customer_aadhaar_number": "XXXXXXXX1234",
"status": "APPROVED",
"pidOptionWadh": "BASE64_OR_WADH_VALUE",
"referenceKey": "REF123456789",
"action": "NO-ACTION-REQUIRED"
},
"order_id": null
}
//KYC required response example
{
"status": 1,
"message": "KYC Required",
"data": {
"customer_aadhaar_number": "XXXXXXXX1234",
"status": "PENDING",
"pidOptionWadh": "BASE64_OR_WADH_VALUE",
"referenceKey": "REF123456789",
"action": "BIOMETRIC-KYC-REQUIRED"
},
"order_id": null
}
// Failed response
{
"status": 2,
"message": "Invalid Data",
"data": {
"customer_aadhaar_number": "",
"status": "",
"pidOptionWadh": "",
"referenceKey": "",
"action": ""
},
"order_id": null
}
Please Note:
To avoid transaction failures and account suspension, for every merchant you need to pass the unique outlet Id in the headers.