Pine LabsDOCS

Submit OTP for Card/BNPL/Wallet Payment

POST/api/pay/v1/otp/submit

Submit the OTP received on the customer's registered mobile number to validate and process the payment. This endpoint is shared between Card Payments (native OTP flow), BNPL, and Brand Wallet payment verification.

Requires Bearer token. Get token →

Header Parameters

FieldDetails
Request-Timestamp
stringdate-time

ISO 8601 UTC timestamp of the request. Used for idempotency and audit.

Request-ID
string

Use a global unique identifier [GUID] for the request.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Request Bodyrequired

FieldDetails
payment_id
stringrequired

Unique payment identifier from create payment response.

otp
stringrequired

OTP received by the customer.

Status Codes

Run
Request
curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/otp/submit \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --data '{
  "payment_id": "v1-250708064524-aa-Zd1J9Y-bn-a",
  "otp": "123456"
}'