Управление заказами
Заказы в DanDanPay Reseller API создаются по выбранному офферу и автоматически маршрутизируются на исполнение.
1. Создание заказа: POST /v1/orders
Заголовок раздела «1. Создание заказа: POST /v1/orders»Для создания заказа передайте идентификатор оффера (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" } }'Параметры тела запроса (CreateOrderDto)
Заголовок раздела «Параметры тела запроса (CreateOrderDto)»| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
offer_id |
UUID | Да | ID оффера из каталога (GET /v1/offers) |
input |
object | Нет | Данные пользователя согласно order_input_schema оффера |
Ответ 202 Accepted
Заголовок раздела «Ответ 202 Accepted»При успешном принятии заказа возвращается объект 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}Возможные ошибки при создании заказа
Заголовок раздела «Возможные ошибки при создании заказа»1. Недостаточно средств: 402 Payment Required
Заголовок раздела «1. Недостаточно средств: 402 Payment Required»На балансе воркспейса нет достаточной суммы для списания:
{ "code": "INSUFFICIENT_FUNDS", "message": "Insufficient funds on reseller account"}2. Оффер временно отключен: 422 Unprocessable Entity
Заголовок раздела «2. Оффер временно отключен: 422 Unprocessable Entity»Оффер помечен как 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"}2. Получение данных заказа: GET /v1/orders/{id}
Заголовок раздела «2. Получение данных заказа: GET /v1/orders/{id}»Возвращает актуальное состояние заказа по его 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 при отсутствии действий клиента |
3. Список заказов воркспейса: GET /v1/orders
Заголовок раздела «3. Список заказов воркспейса: GET /v1/orders»Поддерживает фильтрацию по статусам и постраничную навигацию:
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) и список доступных для покупки персональных лимитированных офферов воркспейса.
Пример для Mobile Legends: Bang Bang
Заголовок раздела «Пример для Mobile Legends: Bang Bang»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" } }'Ответ 200 OK
Заголовок раздела «Ответ 200 OK»{ "recipient": { "name": "Индиана*24", "username": null, "avatar_url": null }, "limited_offers": [ { "id": "01981de8-7cb6-77e0-a2f0-3a174689750d", "offer_title": "150+150" } ]}Пример для Telegram (stars / premium)
Заголовок раздела «Пример для Telegram (stars / premium)»Передайте 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" } }'Ответ 200 OK
Заголовок раздела «Ответ 200 OK»{ "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 |
Внешний сервис проверки получателя временно недоступен |