2FA, OTP & Credentials
When fulfilling specific games and services, a supplier may require a one-time authentication code (OTP/2FA), an authorization link for a new device, or account login credentials.
DanDanPay provides a fully automated asynchronous workflow for credential exchange.
1. Incoming Event: order.credentials_requested
Section titled “1. Incoming Event: order.credentials_requested”When a provider requests verification data, the platform dispatches a webhook to your server:
{ "event_id": "evt_019c8f00-0000-7000-8000-000000000001", "event": "order.credentials_requested", "version": 1, "created_at": "2026-09-13T10:05:00.000Z", "data": { "order_id": "019818bc-1285-7c55-9477-5020aebf7782", "type": "otp", "is_repeat": false, "requested_at": "2026-09-13T10:05:00.000Z", "expires_in": 300, "expires_at": "2026-09-13T10:10:00.000Z", "meta": { "step": "login_verification" } }}data Object Fields
Section titled “data Object Fields”| Field | Type | Description |
|---|---|---|
order_id |
UUID | Unique order identifier |
type |
string | Credential type (otp, link, password, etc.) |
is_repeat |
boolean | true if a previously submitted code was invalid or expired |
expires_in |
integer | Request time-to-live in seconds (e.g. 300s / 5 minutes) |
expires_at |
string (ISO 8601) | Exact timestamp when the request expires |
2. Submitting Credentials: POST /v1/orders/{id}/credentials
Section titled “2. Submitting Credentials: POST /v1/orders/{id}/credentials”Once the customer provides their code or confirmation, immediately send it to the API:
curl -X POST "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782/credentials" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "otp", "code": "582194" }'Request Body Parameters (SubmitOrderCredentialsDto)
Section titled “Request Body Parameters (SubmitOrderCredentialsDto)”| Field | Type | Required | Description |
|---|---|---|---|
type |
string | No | Credential type (otp, link, password) |
code |
string | No | One-time numeric or alphanumeric code (OTP/2FA) |
link |
string | No | Device authorization / verification link |
password |
string | No | Account password (if applicable) |
meta |
object | No | Arbitrary supplementary metadata |
Successful Response 200 OK
Section titled “Successful Response 200 OK”{ "success": true, "message": "Credentials submitted successfully"}After submitting credentials, the data is instantly forwarded to the fulfillment provider, and order processing resumes.