Skip to content
Dashboard

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"
}
}
}
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:

Terminal window
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
{
"success": true,
"message": "Credentials submitted successfully"
}

After submitting credentials, the data is instantly forwarded to the fulfillment provider, and order processing resumes.