Payer routes

Confirm the email code

POST/v1/payer/deposit-requests/{id}/verify/email/confirm

Confirms the code on the session. Unlocks content; raises verification.approved.

Unauthenticated · Payday-Payer-Session unlocks gated content.

Request

Shell
curl -fsS -X POST "$API/v1/payer/deposit-requests/dr_0198f80c-…/verify/email/confirm" \
  -H "Payday-Payer-Session: $PAYER_SESSION" \
  -H "Content-Type: application/json" \
  -d '{ "otp": "123456" }'

Response

200 OK
{
  "requirements": { "email": "approved", "wallet": "pending", "merchant_session": "not_required", "complete": true }
}

On 503 verification_persistence_unavailable the body carries a continuation valid five minutes. Retry this route with { "continuation" } on the same session.

Headers

Payday-Payer-Sessionstring
Payer session token.

Path parameters

iddr_ idrequired

Body

otpstring
Six digits.
continuationstring
Exclusive with otp.

Response

{ requirements }.

Status codes

  • 401otp_invalid
  • 401payer_session_invalid
  • 409verification_not_started No outstanding code.
  • 503verification_persistence_unavailable Retry with continuation.