Перейти к содержимому
Дашборд

Управление заказами

Заказы в DanDanPay Reseller API создаются по выбранному офферу и автоматически маршрутизируются на исполнение.


Для создания заказа передайте идентификатор оффера (offer_id) и параметры пополнения (input):

Окно терминала
curl -X POST "https://api.dandanpay.net/v1/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
"input": {
"game_user_key": "1919293471",
"game_server_key": "6956"
}
}'
Поле Тип Обязательно Описание
offer_id UUID Да ID оффера из каталога (GET /v1/offers)
input object Нет Данные пользователя согласно order_input_schema оффера

При успешном принятии заказа возвращается объект OrderResponseDto:

{
"id": "019818bc-1285-7c55-9477-5020aebf7782",
"offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
"status": "pending",
"price": "1.0958",
"currency": "USD",
"reason": null,
"delivered_at": null,
"client_confirmed_at": null,
"disputed_at": null,
"auto_confirm_at": null
}

На балансе воркспейса нет достаточной суммы для списания:

{
"code": "INSUFFICIENT_FUNDS",
"message": "Insufficient funds on reseller account"
}

Оффер помечен как disabled: true:

{
"code": "OFFER_DISABLED",
"message": "Offer is currently disabled"
}

3. Ошибка валидации параметров: 422 Unprocessable Entity

Заголовок раздела «3. Ошибка валидации параметров: 422 Unprocessable Entity»

Параметры в input не соответствуют схеме:

{
"code": "INVALID_ORDER_INPUT",
"message": "Input validation failed: game_user_key is required"
}

Возвращает актуальное состояние заказа по его UUID:

Окно терминала
curl -X GET "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"
{
"id": "019818bc-1285-7c55-9477-5020aebf7782",
"offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
"status": "completed",
"price": "1.0958",
"currency": "USD",
"reason": null,
"delivered_at": "2026-09-13T10:00:00.000Z",
"client_confirmed_at": "2026-09-13T10:02:15.000Z",
"disputed_at": null,
"auto_confirm_at": "2026-09-14T10:00:00.000Z"
}
Поле Тип Описание
id UUID Идентификатор заказа
offer_id UUID Идентификатор оффера
status string Статус: pending, processing, completed, error, failed
price string Итоговая сумма заказа в USD (decimal-строка, до 6 знаков после запятой без лишних нулей)
currency string Валюта (USD)
reason object / null Причина ошибки (code, message), если статус error или failed
delivered_at string / null Время отгрузки/доставки товара поставщиком (ISO 8601)
client_confirmed_at string / null Время подтверждения получения покупателем (ISO 8601)
disputed_at string / null Время открытия спора покупателем (ISO 8601)
auto_confirm_at string / null Дедлайн автоподтверждения заказа по SLA при отсутствии действий клиента

Поддерживает фильтрацию по статусам и постраничную навигацию:

Окно терминала
curl -X GET "https://api.dandanpay.net/v1/orders?status=processing&page=1&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"
{
"results": [
{
"id": "019818bc-1285-7c55-9477-5020aebf7782",
"offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e",
"status": "processing",
"price": "1.0958",
"currency": "USD"
}
],
"meta": {
"total": 1,
"page": 1,
"limit": 20
}
}

4. Предзаказная валидация получателя и лимитированных офферов: POST /v1/orders/validate

Заголовок раздела «4. Предзаказная валидация получателя и лимитированных офферов: POST /v1/orders/validate»

Позволяет проверить данные получателя (input в формате order_input_schema оффера) до создания заказа по идентификатору бренда (brand_id — UUID или slug) и опциональному идентификатору продукта (product_id — UUID или slug), получить проверенный профиль получателя (игровой никнейм или профиль в Telegram) и список доступных для покупки персональных лимитированных офферов воркспейса.

Окно терминала
curl -X POST "https://api.dandanpay.net/v1/orders/validate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"brand_id": "mlbb",
"product_id": "crystals",
"input": {
"game_user_key": "1919293471",
"game_server_key": "6956"
}
}'
{
"recipient": {
"name": "Индиана*24",
"username": null,
"avatar_url": null
},
"limited_offers": [
{
"id": "01981de8-7cb6-77e0-a2f0-3a174689750d",
"offer_title": "150+150"
}
]
}

Передайте product_id: "stars" (по умолчанию, или его UUID) или product_id: "premium" (или его UUID — дополнительно проверяет возможность подарить подписку Telegram Premium выбранному пользователю):

Окно терминала
curl -X POST "https://api.dandanpay.net/v1/orders/validate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"brand_id": "telegram",
"product_id": "stars",
"input": {
"username": "durov"
}
}'
{
"recipient": {
"name": "Pavel Durov",
"username": "durov",
"avatar_url": "https://t.me/i/userpic/320/durov.jpg"
},
"limited_offers": []
}
HTTP статус Код (code) Описание
400 Bad Request VALIDATION_FAILED Ошибка валидации структуры тела запроса
400 Bad Request INVALID_ORDER_INPUT Поле input не соответствует JSON-схеме order_input_schema продукта
422 Unprocessable Entity BRAND_NOT_FOUND Бренд с указанным brand_id (UUID или slug) не найден
422 Unprocessable Entity PRODUCT_NOT_FOUND Продукт с указанным product_id (UUID или slug) не найден
422 Unprocessable Entity VALIDATION_NOT_SUPPORTED Внешняя предзаказная проверка для указанного бренда или product_id не поддерживается
422 Unprocessable Entity INVALID_RECIPIENT Получатель не найден либо не может принять выбранный продукт
429 Too Many Requests RATE_LIMIT_EXCEEDED Превышен лимит запросов на проверку получателя, повторите попытку позже
502 Bad Gateway UPSTREAM_UNAVAILABLE Внешний сервис проверки получателя временно недоступен