Подтверждение доставки и споры
После выполнения пополнения или отгрузки цифрового товара поставщиком заказ переходит в фазу ожидания подтверждения клиентом.
Платформа защищает обе стороны сделки: покупатель может проверить поступление товара и подтвердить заказ, либо открыть спор, если баланс не пополнился.
1. Уведомление о доставке: order.receipt-requested
Заголовок раздела «1. Уведомление о доставке: order.receipt-requested»Когда товар отгружен, платформа отправляет вебхук:
{ "event_id": "evt_019c8f00-0000-7000-8000-000000000002", "event": "order.receipt-requested", "version": 1, "created_at": "2026-09-13T10:15:00.000Z", "data": { "order_id": "019818bc-1285-7c55-9477-5020aebf7782", "delivered_at": "2026-09-13T10:15:00.000Z", "auto_confirm_at": "2026-09-14T10:15:00.000Z", "screenshots": [ "https://cdn.dandanpay.net/proofs/mlbb-diamonds-delivered.jpg" ], "meta": {} }}Параметры события
Заголовок раздела «Параметры события»delivered_at: точное время доставки товара.auto_confirm_at: крайний срок (дедлайн по SLA), до которого клиент может подтвердить получение или заявить претензию.screenshots: ссылки на скриншоты выполнения заказа от поставщика (если применимо).
2. Подтверждение получения: POST /v1/orders/{id}/confirm-receipt
Заголовок раздела «2. Подтверждение получения: POST /v1/orders/{id}/confirm-receipt»Когда покупатель нажимает в вашем магазине «Товар получен» (или вы самостоятельно убедились в зачислении):
curl -X POST "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782/confirm-receipt" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"Ответ 200 OK
Заголовок раздела «Ответ 200 OK»{ "success": true, "message": "Order receipt confirmed successfully"}Заказ фиксирует время client_confirmed_at и переходит в статус completed. Списанные средства окончательно зачисляются поставщику.
3. Открытие спора (претензии): POST /v1/orders/{id}/dispute
Заголовок раздела «3. Открытие спора (претензии): POST /v1/orders/{id}/dispute»Если клиент сообщил, что кристаллы или валюта не поступили, или доставлен не тот объем:
curl -X POST "https://api.dandanpay.net/v1/orders/019818bc-1285-7c55-9477-5020aebf7782/dispute" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "reason": "Клиент утверждает, что кристаллы не поступили на аккаунт. Скриншот из игры приложен." }'Ответ 200 OK
Заголовок раздела «Ответ 200 OK»{ "success": true, "message": "Order dispute submitted successfully"}Что происходит при открытии спора:
Заголовок раздела «Что происходит при открытии спора:»- В заказе фиксируется время
disputed_at. - Таймер автоподтверждения
auto_confirm_atзамораживается. - Заказ передается в арбитраж службы поддержки DanDanPay для ручной сверки логов пополнения с поставщиком.
4. Автоматическое подтверждение по SLA
Заголовок раздела «4. Автоматическое подтверждение по SLA»Если покупатель не подтвердил получение и не открыл диспут до наступления времени auto_confirm_at:
- Платформа автоматически считает заказ успешно выполненным.
- Заказ переводится в статус
completed.