2FA, OTP и учетные данные
При пополнении некоторых сервисов и внутриигровых наборов исполнителю может потребоваться одноразовый код аутентификации (OTP/2FA), ссылка подтверждения нового устройства или пароль аккаунта.
DanDanPay предоставляет полностью автоматизированный асинхронный механизм передачи учетных данных.
1. Входящее событие: order.credentials_requested
Заголовок раздела «1. Входящее событие: order.credentials_requested»Когда исполнителю требуется код, платформа отправляет на ваш сервер вебхук:
{ "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
Заголовок раздела «Поля объекта data»| Поле | Тип | Описание |
|---|---|---|
order_id |
UUID | Идентификатор заказа |
type |
string | Тип учетных данных (otp, link, password и др.) |
is_repeat |
boolean | true, если ранее переданный код был неверным или истек |
expires_in |
integer | Время жизни запроса в секундах (например, 300 сек / 5 минут) |
expires_at |
string (ISO 8601) | Точное время истечения запроса |
2. Передача учетных данных: POST /v1/orders/{id}/credentials
Заголовок раздела «2. Передача учетных данных: POST /v1/orders/{id}/credentials»Получив код или ссылку от покупателя, немедленно отправьте их в 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" }'Параметры тела запроса (SubmitOrderCredentialsDto)
Заголовок раздела «Параметры тела запроса (SubmitOrderCredentialsDto)»| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
type |
string | Нет | Тип данных (otp, link, password) |
code |
string | Нет | Одноразовый цифровой или буквенный код (OTP/2FA) |
link |
string | Нет | Ссылка подтверждения входа / авторизации устройства |
password |
string | Нет | Пароль (если применимо) |
meta |
object | Нет | Произвольные дополнительные метаданные |
Успешный ответ 200 OK
Заголовок раздела «Успешный ответ 200 OK»{ "success": true, "message": "Credentials submitted successfully"}После вызова эндпоинта данные моментально передаются исполнителю, а процесс доставки заказа продолжается.