Skip to content
Dashboard

Order Management

Orders in the DanDanPay Reseller API are created against selected offers and automatically dispatched for fulfillment.


To place an order, provide the offer ID (offer_id) and fulfillment parameters (input):

Terminal window
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"
}
}'
Field Type Required Description
offer_id UUID Yes Offer ID from catalog (GET /v1/offers)
input object No Customer fulfillment payload adhering to order_input_schema

Upon successful acceptance, the API responds with an 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. Insufficient Funds: 402 Payment Required

Section titled “1. Insufficient Funds: 402 Payment Required”

The workspace balance does not hold enough available funds:

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

2. Offer Temporarily Disabled: 422 Unprocessable Entity

Section titled “2. Offer Temporarily Disabled: 422 Unprocessable Entity”

The offer is currently flagged with disabled: true:

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

3. Parameter Validation Error: 422 Unprocessable Entity

Section titled “3. Parameter Validation Error: 422 Unprocessable Entity”

Values in input fail schema verification:

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

Returns the current state and timestamps for an order by UUID:

Terminal window
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"
}
Field Type Description
id UUID Unique order ID
offer_id UUID Ordered offer ID
status string Current state: pending, processing, completed, error, failed
price string Total order cost in USD (decimal string, up to 6 decimal places without trailing zeros)
currency string Settlement currency (USD)
reason object / null Failure details (code, message) when status is error or failed
delivered_at string / null Provider delivery timestamp (ISO 8601)
client_confirmed_at string / null Customer receipt confirmation timestamp (ISO 8601)
disputed_at string / null Dispute opening timestamp (ISO 8601)
auto_confirm_at string / null SLA auto-confirmation deadline

Supports status filtering and pagination:

Terminal window
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. Pre-order Recipient & Limited Offers Validation: POST /v1/orders/validate

Section titled “4. Pre-order Recipient & Limited Offers Validation: POST /v1/orders/validate”

Validates recipient input (input matching the offer’s order_input_schema) prior to placing an order by brand identifier (brand_id — UUID or slug) and optional product identifier (product_id — UUID or slug), returning the verified recipient profile (in-game nickname or Telegram profile) and the list of personal limited workspace offers available for purchase.

Terminal window
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"
}
]
}

Pass product_id: "stars" (default, or its UUID) or product_id: "premium" (or its UUID — additionally checks whether the recipient is eligible to receive a Telegram Premium gift subscription):

Terminal window
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 Status Code (code) Description
400 Bad Request VALIDATION_FAILED Request body structure validation failed
400 Bad Request INVALID_ORDER_INPUT input does not conform to order_input_schema
422 Unprocessable Entity BRAND_NOT_FOUND Brand with the provided brand_id (UUID or slug) was not found
422 Unprocessable Entity PRODUCT_NOT_FOUND Product with the provided product_id (UUID or slug) was not found
422 Unprocessable Entity VALIDATION_NOT_SUPPORTED External pre-order validation is not supported for this brand or product_id
422 Unprocessable Entity INVALID_RECIPIENT Recipient was not found or cannot receive the selected product
429 Too Many Requests RATE_LIMIT_EXCEEDED Validation rate limit exceeded, retry later
502 Bad Gateway UPSTREAM_UNAVAILABLE External recipient verification service is temporarily unavailable