DigiLocker Verify Account

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

📘

Before you call this API

Send your issued secret header and Content-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 body ip field 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

FieldTypeRequiredValidation / Description
mobile_numberstringYesExactly 10 numeric digits.
latitudedecimalYesCustomer/outlet latitude.
longitudedecimalYesCustomer/outlet longitude.
ipstringYesValid IPv4 address associated with the transaction/customer.
request_idstringYesClient 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.statusMeaningNext user_flow
ACCOUNT_EXISTSDigiLocker account exists for the mobile number.signin
ACCOUNT_NOT_FOUNDNo DigiLocker account was found.signup

🚧

Check the application result

Always inspect JSON status, message, and any errors object. A successful HTTP response does not establish verification completion. Invalid JSON, invalid parameters, authentication failure, or unavailable service can return status: 2. For field validation errors, errors maps field names to messages.

See the Verification Integration Guide for the full consent journey, status handling, and examples.

Body Params
string
required

Exactly 10 numeric digits.

string
required

Decimal latitude.

string
required

Decimal longitude.

string
required

Valid IPv4 address.

string
required

Unique reference, minimum 8 characters.

Headers
string
required

Pay2New-issued API secret.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json