Skip to content
Dashboard

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": {}
}
}
  • 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):

Terminal window
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"
{
"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:

Terminal window
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."
}'
{
"success": true,
"message": "Order dispute submitted successfully"
}
  • disputed_at is set on the order object.
  • The auto_confirm_at countdown timer is frozen.
  • The order is escalated to DanDanPay support arbitration for manual log reconciliation with the provider.

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.