POSTVerify Sender OTP

Verify the sender OTP to authenticate the PPI Levin wallet and return the sender's profile and balance.

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

Validates the OTP issued by Get Sender Information / Onboard Sender. For an existing sender the response returns the full wallet customer_profile (limits, balance, KYC state) and a wallet_token used by downstream calls. For a new customer the flow continues to Aadhaar validation (Aadhar Validation Pending) and then PAN (Pan Number Required).

Request

Path parameters

Field	Type	Required	Description
`customer_id`	string	required	Sender's 10-digit mobile number.e.g. 9444444444

customer_idstringRequired

Sender's 10-digit mobile number.

example: 9444444444

Body parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`client_ref_id`	string	optional	Unique reference ID per API call, generated by your system (max 20 characters).e.g. 2026010100123456789
`otp`	integer	required	OTP received from Get Sender Information, Onboard Sender, or Validate Aadhaar.e.g. 123456
`otp_ref_id`	integer	required	otp_ref_id received from Get Sender Information, Onboard Sender, or Validate Aadhaar.e.g. 66748392
`intent_id`	string	required	Intent flag: "19" for sender onboarding, "20" for Aadhaar validation.e.g. 19

initiator_idstringRequired

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

example: 9962981729

client_ref_idstringoptional

Unique reference ID per API call, generated by your system (max 20 characters).

example: 2026010100123456789

otpintegerRequired

OTP received from Get Sender Information, Onboard Sender, or Validate Aadhaar.

example: 123456

otp_ref_idintegerRequired

otp_ref_id received from Get Sender Information, Onboard Sender, or Validate Aadhaar.

example: 66748392

intent_idstringRequired

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

example: 19

These headers authenticate and sign every request. See How Auth Works for details.

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.
- customer_profileobject
  Sender's wallet profile — limits, balance, KYC state, and usage chart.
  - namestring
    Registered name of the sender.
  - mobilestring
    Sender's mobile number.
  - total_monthly_limitstring
    Total monthly transfer limit (INR).
  - next_allowed_limitstring
    Remaining transfer limit for the period (INR).
  - balancestring
    Current wallet balance (INR).
  - ekyc_enablednumber
    Whether biometric eKYC is enabled (1) or not (0).
  - kyc_statenumber
    KYC completion state.
  - chartarray
    Usage breakdown (used / remaining / unavailable).
    - data_type_idnumber
      Chart data type identifier.
    - dataobject
      Used / remaining / unavailable amounts.
      - usednumber
        Amount used in the period (INR).
      - remainingnumber
        Amount remaining in the period (INR).
      - unavailablenumber
        Amount blocked/unavailable (INR).
- wallet_tokenstring
  Wallet authentication token (JWT) required by downstream PPI Levin calls.
- is_registerednumber
  Whether the sender is already fully registered.
- next_allowed_limitnumber
  Remaining transfer limit at the top level (INR).

Next steps

NextPOSTValidate PANValidate the sender's PAN to complete PPI Levin KYC and return the updated wallet profile.

Request

Path parameters

Body parameters

Responses

Next steps

Related