| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Before you call this API
Send your issued
secretheader andContent-Type: application/json. Your source IP must be registered on the partner account, and the account, KYC, wallet, API access, and DigiLocker service must be active. The bodyipfield does not replace the source-IP check.
Checks whether the supplied mobile number is associated with a DigiLocker account. Use the result to select signin or signup when creating the consent URL.
POST https://pay2new.in/apis/v1/verification/digilocker/verifyAccount
Request fields
| Field | Type | Required | Validation / Description |
|---|---|---|---|
mobile_number | string | Yes | Exactly 10 numeric digits. |
latitude | decimal | Yes | Customer/outlet latitude. |
longitude | decimal | Yes | Customer/outlet longitude. |
ip | string | Yes | Valid IPv4 address associated with the transaction/customer. |
request_id | string | Yes | Client request reference, minimum 8 characters. |
cURL example
curl --request POST \
--url 'https://pay2new.in/apis/v1/verification/digilocker/verifyAccount' \
--header 'secret: <YOUR_PAY2NEW_SECRET>' \
--header 'Content-Type: application/json' \
--data '{
"mobile_number": "9999999999",
"latitude": "19.0760",
"longitude": "72.8777",
"ip": "203.0.113.10",
"request_id": "DLACC202608260001"
}'
Success response example
{
"status": 1,
"message": "Success",
"operator_reference": 12345678,
"data": {
"verification_id": "DLV202608260001",
"mobile_number": "9999999999",
"status": "ACCOUNT_EXISTS",
"digilocker_id": "8aa626bf-34aa-5ffc-a123-f69207e129a7"
}
}
data.status | Meaning | Next user_flow |
|---|---|---|
ACCOUNT_EXISTS | DigiLocker account exists for the mobile number. | signin |
ACCOUNT_NOT_FOUND | No DigiLocker account was found. | signup |
Check the application result
Always inspect JSON
status,message, and anyerrorsobject. A successful HTTP response does not establish verification completion. Invalid JSON, invalid parameters, authentication failure, or unavailable service can returnstatus: 2. For field validation errors,errorsmaps field names to messages.
See the Verification Integration Guide for the full consent journey, status handling, and examples.
