post
https://pay2new.in/apis/onboard/v1/customerMinKyc
This API is used to onboard a customer using PAN-based details. No OTP validation step is required for this PAN-based onboarding flow.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Header Request
secret : Unique secret key (Provided by Pay2New)
Note
Latitude and Longitude must be represented in degrees with 4 digits after decimal.
Please ensure that the address entered is the same as the address registered with Aadhaar.
The name and date of birth must exactly match the details registered with PAN.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| mobile_number | string | Yes | Customer mobile number, 10 digits |
| pan_number | string | Yes | Customer PAN number |
| name | string | Yes | Customer full name as per PAN/Aadhaar |
| gender | string | Yes | Customer gender. Allowed values: M, F, O |
| string | Yes | Customer email address | |
| aadhaar_number | string | Yes | Customer Aadhaar number, 12 digits |
| address | string | Yes | Full customer address |
| city | string | Yes | Customer city |
| pincode | string | Yes | Customer pincode, 6 digits |
| dob | string | Yes | Date of birth in YYYY-MM-DD format |
| latitude | string | Yes | Customer/device latitude |
| longitude | string | Yes | Customer/device longitude |
| terms_agree | string | Yes | Must be Y |
| ip | string | Yes | End user IPv4 address |
| request_id | string | Yes | Unique request ID, minimum 8 characters |
Sample Request
curl --location 'https://pay2new.in/apis/v1/onboard/customerMinKyc' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'secret: YOUR_ENCRYPTED_SECRET' \
--data-raw '{
"mobile_number": "9876543210",
"pan_number": "ABCDE1234F",
"name": "RAHUL RAMESH SHARMA",
"gender": "M",
"email": "[email protected]",
"aadhaar_number": "123456789012",
"address": "OFFICE NO 301, 3RD FLOOR, KRUSHNA COMPLEX, PIPELINE RD, NEAR SHRIRAM CHOWK",
"city": "AHILYANAGAR",
"pincode": "414003",
"dob": "1990-05-15",
"latitude": "19.1258",
"longitude": "74.7453",
"terms_agree": "Y",
"ip": "103.123.76.131",
"request_id": "REQ9876543210"
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://pay2new.in/apis/v1/onboard/customerMinKyc',
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 =>'{
"mobile_number": "9876543210",
"pan_number": "ABCDE1234F",
"name": "RAHUL RAMESH SHARMA",
"gender": "M",
"email": "[email protected]",
"aadhaar_number": "123456789012",
"address": "OFFICE NO 301, 3RD FLOOR, KRUSHNA COMPLEX, PIPELINE RD, NEAR SHRIRAM CHOWK",
"city": "AHILYANAGAR",
"pincode": "414003",
"dob": "1990-05-15",
"latitude": "19.1258",
"longitude": "74.7453",
"terms_agree": "Y",
"ip": "103.123.76.131",
"request_id": "REQ9876543210"
}',
CURLOPT_HTTPHEADER => array(
'Accept: application/json',
'Content-Type: application/json',
'secret: YOUR_ENCRYPTED_SECRET'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| status | integer | API response status. 1 means success, 2 means failed/invalid request |
| message | string | Response message returned by the API |
| order_id | string | Unique Pay2New transaction/order ID generated for this onboarding request |
| request_id | string | Same unique request ID sent in the request |
| data | object | Customer onboarding/KYC details returned after successful verification |
| data.name | string | Customer full name |
| data.address | string | Customer address |
| data.gender | string | Customer gender. Possible values: M, F, O |
| data.pincode | string | Customer pincode |
| data.dob | string | Customer date of birth in YYYY-MM-DD format |
| data.state | string | Customer state name |
| data.district | string | Customer district name |
| data.photo | string/null | Customer photo, if available. Returns null if not available |
| data.pan_number | string | Customer PAN number |
| outletId | string | Pay2New customer outlet ID. Use this ID for services that require outlet/customer reference |
| errors | object | Validation error details. Available only in failed response |
| errors.mobile_number | string | Validation error message for mobile number field |
Sample Response
{
"status": 1,
"message": "Transaction Successful",
"order_id": "P2F1779450776HZTRL",
"request_id": "REQ9876543210",
"data": {
"name": "RAHUL RAMESH SHARMA",
"address": "OFFICE NO 301, 3RD FLOOR, KRUSHNA COMPLEX, PIPELINE RD, NEAR SHRIRAM CHOWK",
"gender": "M",
"pincode": "414003",
"dob": "1990-05-15",
"state": "MAHARASHTRA",
"district": "AHILYANAGAR",
"photo": null,
"pan_number": "ABCDE1234F"
},
"outletId": "8102"
}
{
"status": 2,
"message": "Invalid Parameters",
"errors": {
"mobile_number": "The mobile_number field is required."
}
}
Important Notes
- outletId is the Pay2New customer outlet ID.
- Use outletId for services that require outlet/customer reference.
- request_id must be unique for every request.
- No OTP validation step is required for this PAN-based onboarding flow.