Delivery Confirmation & Disputes
Once a digital item is delivered or top-up completed by the provider, the order enters a customer confirmation window.
The platform protects both parties: the buyer can inspect their account balance and confirm receipt, or initiate a dispute if the items were not received.
1. Delivery Notification: order.receipt-requested
Section titled “1. Delivery Notification: order.receipt-requested”When goods are delivered, the platform dispatches a webhook to your server:
{ "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": {} }}Event Parameters
Section titled “Event Parameters”delivered_at: Exact timestamp of item delivery.auto_confirm_at: SLA deadline by which the buyer must either confirm delivery or open a dispute.screenshots: URLs to proof-of-delivery screenshots from the supplier (when applicable).
2. Confirm Receipt: POST /v1/orders/{id}/confirm-receipt
Section titled “2. Confirm Receipt: POST /v1/orders/{id}/confirm-receipt”When the customer clicks “I received my order” (or when your automated systems verify top-up delivery):
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"Response 200 OK
Section titled “Response 200 OK”{ "success": true, "message": "Order receipt confirmed successfully"}The order sets client_confirmed_at and transitions to completed. Reserved funds are permanently settled to the provider.
3. Opening a Dispute: POST /v1/orders/{id}/dispute
Section titled “3. Opening a Dispute: POST /v1/orders/{id}/dispute”If the customer reports that crystals/currency were not received or the wrong denomination was delivered:
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": "Customer states crystals were not credited to the account. In-game screenshot attached." }'Response 200 OK
Section titled “Response 200 OK”{ "success": true, "message": "Order dispute submitted successfully"}What happens when a dispute is opened:
Section titled “What happens when a dispute is opened:”disputed_atis set on the order object.- The
auto_confirm_atcountdown timer is frozen. - The order is escalated to DanDanPay support arbitration for manual log reconciliation with the provider.
4. SLA Auto-Confirmation
Section titled “4. SLA Auto-Confirmation”If the customer neither confirms receipt nor opens a dispute before auto_confirm_at:
- The platform automatically considers the order successfully fulfilled.
- The order transitions to
completed.