Order Management
Orders in the DanDanPay Reseller API are created against selected offers and automatically dispatched for fulfillment.
1. Create an Order: POST /v1/orders
Section titled “1. Create an Order: POST /v1/orders”To place an order, provide the offer ID (offer_id) and fulfillment parameters (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" } }'Request Body Parameters (CreateOrderDto)
Section titled “Request Body Parameters (CreateOrderDto)”| 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 |
Response 202 Accepted
Section titled “Response 202 Accepted”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}Potential Errors on Order Creation
Section titled “Potential Errors on Order Creation”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"}2. Order Lookup: GET /v1/orders/{id}
Section titled “2. Order Lookup: GET /v1/orders/{id}”Returns the current state and timestamps for an order by 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"}Order Response Fields
Section titled “Order Response Fields”| 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 |
3. Orders List: GET /v1/orders
Section titled “3. Orders List: GET /v1/orders”Supports status filtering and pagination:
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.
Example: Mobile Legends: Bang Bang
Section titled “Example: 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" } }'Response 200 OK
Section titled “Response 200 OK”{ "recipient": { "name": "Индиана*24", "username": null, "avatar_url": null }, "limited_offers": [ { "id": "01981de8-7cb6-77e0-a2f0-3a174689750d", "offer_title": "150+150" } ]}Example: Telegram (stars / premium)
Section titled “Example: Telegram (stars / premium)”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):
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" } }'Response 200 OK
Section titled “Response 200 OK”{ "recipient": { "name": "Pavel Durov", "username": "durov", "avatar_url": "https://t.me/i/userpic/320/durov.jpg" }, "limited_offers": []}Validation Error Codes
Section titled “Validation Error Codes”| 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 |