Схемы входных данных (order_input_schema)
В DanDanPay Reseller API параметры для пополнения не захардкожены, а описываются через стандартизированный объект JSON Schema в поле order_input_schema каждого оффера.
При вызове POST /v1/orders вы передаете эти данные в поле input:
{ "offer_id": "01981de8-7cb4-7f54-8672-57eb8ee8b47e", "input": { "game_user_key": "1919293471", "game_server_key": "6956" }}Примеры схем для популярных дисциплин
Заголовок раздела «Примеры схем для популярных дисциплин»Mobile Legends: Bang Bang
Заголовок раздела «Mobile Legends: Bang Bang»Схема оффера:
{ "type": "object", "required": ["game_user_key", "game_server_key"], "properties": { "game_user_key": { "type": "string", "description": "ID игрока (цифры до скобок)" }, "game_server_key": { "type": "string", "description": "Зона/сервер (4 цифры в скобках)" } }, "additionalProperties": false}Объект input при создании заказа:
{ "game_user_key": "1919293471", "game_server_key": "6956"}Genshin Impact
Заголовок раздела «Genshin Impact»Схема оффера:
{ "type": "object", "required": ["game_user_key", "game_server_key"], "properties": { "game_user_key": { "type": "string", "description": "UID игрока (9 цифр)" }, "game_server_key": { "type": "string", "enum": ["os_euro", "os_usa", "os_asia", "os_cht"], "description": "Регион сервера" } }, "additionalProperties": false}Объект input:
{ "game_user_key": "701984251", "game_server_key": "os_euro"}Honkai: Star Rail
Заголовок раздела «Honkai: Star Rail»Схема оффера:
{ "type": "object", "required": ["game_user_key", "game_server_key"], "properties": { "game_user_key": { "type": "string", "description": "UID игрока (9 цифр)" }, "game_server_key": { "type": "string", "enum": ["prod_official_eur", "prod_official_usa", "prod_official_asia", "prod_official_cht"], "description": "Сервер" } }, "additionalProperties": false}Объект input:
{ "game_user_key": "700145239", "game_server_key": "prod_official_eur"}PUBG Mobile
Заголовок раздела «PUBG Mobile»Схема оффера:
{ "type": "object", "required": ["game_user_key"], "properties": { "game_user_key": { "type": "string", "description": "Player ID (цифровой ID аккаунта)" } }, "additionalProperties": false}Объект input:
{ "game_user_key": "5123456789"}Steam пополнение
Заголовок раздела «Steam пополнение»Схема оффера:
{ "type": "object", "required": ["login"], "properties": { "login": { "type": "string", "description": "Логин аккаунта Steam для авторизации" } }, "additionalProperties": false}Объект input:
{ "login": "steam_player_login"}Валидация и обработка ошибок
Заголовок раздела «Валидация и обработка ошибок»Если переданный input не соответствует схеме оффера (пропущен обязательный параметр, передан неверный тип или лишнее свойство при additionalProperties: false), API вернет ошибку 400 Bad Request или 422 Unprocessable Entity:
HTTP/1.1 422 Unprocessable EntityContent-Type: application/json
{ "code": "INVALID_ORDER_INPUT", "message": "Validation failed: 'game_server_key' is required"}Всегда запрашивайте свежий оффер перед открытием формы оплаты для клиента.