Input Schemas (order_input_schema)
In the DanDanPay Reseller API, fulfillment parameters are not hardcoded. Instead, each offer provides a standardized JSON Schema in the order_input_schema field.
When calling POST /v1/orders, you pass these parameters inside the input field:
{ "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e", "input": { "game_user_key": "1919293471", "game_server_key": "6956" }}Schema Examples for Popular Disciplines
Section titled “Schema Examples for Popular Disciplines”Mobile Legends: Bang Bang
Section titled “Mobile Legends: Bang Bang”Offer schema:
{ "type": "object", "required": ["game_user_key", "game_server_key"], "properties": { "game_user_key": { "type": "string", "description": "Player User ID (numbers before parentheses)" }, "game_server_key": { "type": "string", "description": "Zone/Server ID (4 digits in parentheses)" } }, "additionalProperties": false}input object when placing an order:
{ "game_user_key": "1919293471", "game_server_key": "6956"}Genshin Impact
Section titled “Genshin Impact”Offer schema:
{ "type": "object", "required": ["game_user_key", "game_server_key"], "properties": { "game_user_key": { "type": "string", "description": "Player UID (9 digits)" }, "game_server_key": { "type": "string", "enum": ["os_euro", "os_usa", "os_asia", "os_cht"], "description": "Game server region" } }, "additionalProperties": false}input object:
{ "game_user_key": "701984251", "game_server_key": "os_euro"}Honkai: Star Rail
Section titled “Honkai: Star Rail”Offer schema:
{ "type": "object", "required": ["game_user_key", "game_server_key"], "properties": { "game_user_key": { "type": "string", "description": "Player UID (9 digits)" }, "game_server_key": { "type": "string", "enum": ["prod_official_eur", "prod_official_usa", "prod_official_asia", "prod_official_cht"], "description": "Server" } }, "additionalProperties": false}input object:
{ "game_user_key": "700145239", "game_server_key": "prod_official_eur"}PUBG Mobile
Section titled “PUBG Mobile”Offer schema:
{ "type": "object", "required": ["game_user_key"], "properties": { "game_user_key": { "type": "string", "description": "Player ID (numeric account ID)" } }, "additionalProperties": false}input object:
{ "game_user_key": "5123456789"}Steam Topup
Section titled “Steam Topup”Offer schema:
{ "type": "object", "required": ["login"], "properties": { "login": { "type": "string", "description": "Steam account username / login" } }, "additionalProperties": false}input object:
{ "login": "steam_player_login"}Validation and Error Handling
Section titled “Validation and Error Handling”If the submitted input fails to validate against the offer schema (e.g. missing required property, invalid data type, or extraneous field when additionalProperties: false), the API returns HTTP 400 Bad Request or 422 Unprocessable Entity:
HTTP/1.1 422 Unprocessable EntityContent-Type: application/json
{ "code": "INVALID_ORDER_INPUT", "message": "Validation failed: 'game_server_key' is required"}Always fetch fresh offer metadata before rendering the customer payment/checkout form.