Перейти к содержимому
Дашборд

Схемы входных данных (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"
}
}

Схема оффера:

{
"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"
}

Если переданный input не соответствует схеме оффера (пропущен обязательный параметр, передан неверный тип или лишнее свойство при additionalProperties: false), API вернет ошибку 400 Bad Request или 422 Unprocessable Entity:

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json
{
"code": "INVALID_ORDER_INPUT",
"message": "Validation failed: 'game_server_key' is required"
}

Всегда запрашивайте свежий оффер перед открытием формы оплаты для клиента.