POSTValidate Aadhaar OTP

Verify the Aadhaar OTP to complete identity validation in the PPI Levin wallet onboarding flow.

POST/customer/payment/ppi-levin/sender/{customer_id}/aadhaar/otp/verify

Validates the OTP dispatched during the PPI Levin Aadhaar validation step. On success, the sender's Aadhaar identity is confirmed and their PPI Levin wallet profile is updated with verified KYC data. Wallet-level parameters wallet_token and wallet_id may be required.

Path parameters

Field	Type	Required	Description
`customer_id`	string	required	Sender's mobile number.e.g. 9876543210

customer_idstringRequired

Sender's mobile number.

example: 9876543210

Body parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200
`client_ref_id`	string	optional	Unique reference id per API call, generated by your system.e.g. REQ-20260101-001
`otp`	integer	optional	OTP received on the Aadhaar-linked mobile number.e.g. 654321
`otp_ref_id`	integer	required	Reference ID from the PPI Levin Validate Aadhaar response.e.g. 66748392
`intent_id`	string	optional	Intent flag: "19" for sender onboarding, "20" for Aadhaar validation.e.g. 20
`wallet_token`	string	optional	Wallet token for authenticated context.e.g. wtkn_abc123xyz
`wallet_id`	string	optional	Wallet identifier for the sender.e.g. wlt_0091234

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

client_ref_idstringoptional

Unique reference id per API call, generated by your system.

example: REQ-20260101-001

otpintegeroptional

OTP received on the Aadhaar-linked mobile number.

example: 654321

otp_ref_idintegerRequired

Reference ID from the PPI Levin Validate Aadhaar response.

example: 66748392

intent_idstringoptional

Intent flag: "19" for sender onboarding, "20" for Aadhaar validation.

example: 20

wallet_tokenstringoptional

Wallet token for authenticated context.

example: wtkn_abc123xyz

wallet_idstringoptional

Wallet identifier for the sender.

example: wlt_0091234

Headers

Field	Type	Required	Description
`developer_key`	string	required	Static API key issued to your account after KYC.
`secret-key`	string	required	Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).
`secret-key-timestamp`	string	required	Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.
`content-type`	string	required	application/jsone.g. application/json

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- verifiedboolean
  True if Aadhaar OTP verification was successful.
- namestring
  Verified sender name from Aadhaar.
- genderstring
  Gender from Aadhaar record: M, F, or T.
- dobstring
  Date of birth as per Aadhaar.
- masked_aadhaarstring
  Aadhaar number with first 8 digits masked.