{
"info": {
"_postman_id": "c8d6d8df-c47e-4e67-997e-e93afc6eae8e",
"name": "GMXAZ Bot Public API",
"description": "Коллекция Public API GMXAZ Bot. Base URL: https://gmx.az/api/v1. Содержит все запросы, примеры запросов и ответов, ошибки, переменные, тесты, идемпотентность и примеры webhook.\n\nПодпись webhook: Рекомендуется: sha256=HMAC_SHA256(timestamp + \".\" + event_id + \".\" + raw_json_body, webhook_secret). Используйте заголовки timestamp и event-id, указанные выше.. Импортируйте также Environment JSON и заполните x_api_key, webhook_secret и callback_url.",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"auth": {
"type": "apikey",
"apikey": [
{
"key": "key",
"value": "X-API-KEY",
"type": "string"
},
{
"key": "value",
"value": "{{x_api_key}}",
"type": "string"
},
{
"key": "in",
"value": "header",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
"pm.request.headers.upsert({ key: 'Accept', value: 'application/json' });",
"const requestPath = '/' + pm.request.url.path.join('/');",
"const stableKey = (name) => {",
" let value = pm.collectionVariables.get(name);",
" if (!value) { value = pm.variables.replaceIn('{{$guid}}'); pm.collectionVariables.set(name, value); }",
" return value;",
"};",
"if (pm.request.method === 'POST' && requestPath.endsWith('/order')) {",
" pm.request.headers.upsert({ key: 'X-Idempotency-Key', value: stableKey('order_idempotency_key') });",
"}",
"if (pm.request.method === 'POST' && requestPath.endsWith('/redeem-check')) {",
" pm.request.headers.upsert({ key: 'X-Idempotency-Key', value: stableKey('redeem_idempotency_key') });",
"}"
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
"pm.test('Код статуса не 5xx', function () {",
" pm.expect(pm.response.code).to.be.below(600);",
"});",
"if (pm.response.headers.has('X-Request-Id')) { pm.collectionVariables.set('last_request_id', pm.response.headers.get('X-Request-Id')); }"
]
}
}
],
"variable": [
{
"key": "base_url",
"value": "https://gmx.az/api/v1"
},
{
"key": "x_api_key",
"value": ""
},
{
"key": "webhook_secret",
"value": ""
},
{
"key": "callback_url",
"value": "https://customer.example/webhooks/bot-manager"
},
{
"key": "callback_mode",
"value": "legacy"
},
{
"key": "product_id",
"value": "91"
},
{
"key": "order_id",
"value": "8821"
},
{
"key": "client_order_id",
"value": ""
},
{
"key": "order_idempotency_key",
"value": ""
},
{
"key": "redeem_idempotency_key",
"value": ""
},
{
"key": "player_id",
"value": "51515969536"
},
{
"key": "server_id",
"value": "1234"
},
{
"key": "charname",
"value": "PlayerOne"
},
{
"key": "input_2",
"value": ""
},
{
"key": "input_3",
"value": ""
},
{
"key": "input_4",
"value": ""
},
{
"key": "input_5",
"value": ""
},
{
"key": "input_6",
"value": ""
},
{
"key": "input_7",
"value": ""
},
{
"key": "input_8",
"value": ""
},
{
"key": "redeem_code",
"value": "ABCDEF123456"
},
{
"key": "last_request_id",
"value": ""
}
],
"item": [
{
"name": "Аккаунт",
"description": "Аккаунт",
"item": [
{
"name": "GET /getMe",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"user_id\": 579365494,\n \"username\": \"reseller_pro\",\n \"balance\": \"1250.5000\",\n \"currency\": \"USD\",\n \"webhook_secret_configured\": true\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает API пользователя, баланс и валюту.\n\nИспользуйте этот адрес для проверки API ключа и статуса аккаунта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.",
"url": {
"raw": "{{base_url}}/getMe",
"host": [
"{{base_url}}"
],
"path": [
"getMe"
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
}
]
}
]
},
{
"name": "Каталог",
"description": "Каталог",
"item": [
{
"name": "GET /games",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"PUBG Mobile\",\n \"type\": \"TOPUP\",\n \"categories\": [\n {\n \"id\": 10,\n \"name\": \"Global\",\n \"per_page_count\": 12\n }\n ]\n }\n ]\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные игры и категории.\n\nИгры можно фильтровать по типу и искать по названию.\n\n## Parameters\n- `type` (query, optional): Фильтр типа товара.\n- `q` (query, optional): Поиск по названию игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Параметр type или q имеет неверный формат.",
"url": {
"raw": "{{base_url}}/games",
"host": [
"{{base_url}}"
],
"path": [
"games"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "Фильтр типа товара.",
"disabled": true
},
{
"key": "q",
"value": "pubg",
"description": "Поиск по названию игры.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Параметр type или q имеет неверный формат.\"\n }\n}"
}
]
},
{
"name": "GET /categories",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": 10,\n \"name\": \"Global\",\n \"per_page_count\": 12\n }\n ]\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"game_id не передан или не является целым числом.\"\n }\n}"
},
{
"name": "GAME_NOT_FOUND",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает активные категории выбранной игры.\n\ngame_id обязателен и берётся из ответа /games.\n\n## Parameters\n- `game_id` (query, required): ID активной игры.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: game_id не передан или не является целым числом.\n- `GAME_NOT_FOUND` HTTP 404: Игра не найдена или неактивна.",
"url": {
"raw": "{{base_url}}/categories",
"host": [
"{{base_url}}"
],
"path": [
"categories"
],
"query": [
{
"key": "game_id",
"value": "1",
"description": "ID активной игры.",
"disabled": false
}
]
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"GAME_NOT_FOUND\",\n \"message\": \"Игра не найдена или неактивна.\"\n }\n}"
}
]
},
{
"name": "GET /products",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": [\n {\n \"id\": 91,\n \"name\": \"PUBG Mobile 60 UC\",\n \"game_id\": 1,\n \"game\": \"PUBG Mobile\",\n \"category_id\": 10,\n \"category\": \"Global\",\n \"type\": \"TOPUP\",\n \"fulfillment_type\": \"standard\",\n \"is_qr_login\": false,\n \"price\": \"0.8800\",\n \"currency\": \"USD\",\n \"stock_status\": \"INFINITE\",\n \"stock_count\": null,\n \"min_qty\": 1,\n \"max_qty\": 1,\n \"fields\": [\n {\n \"key\": \"player_id\",\n \"label\": \"ID игрока\",\n \"required\": true\n }\n ],\n \"supports_player_validation\": true\n }\n ],\n \"meta\": {\n \"current_page\": 1,\n \"last_page\": 1,\n \"per_page\": 50,\n \"total\": 1\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает товары, цены, остатки, поля и пагинацию.\n\nФильтры можно использовать вместе. Возвращаются товары активных игр и категорий.\n\n## Parameters\n- `type` (query, optional): voucher или topup.\n- `game` (query, optional): Частичный поиск по названию игры.\n- `category` (query, optional): Частичный поиск по названию категории.\n- `game_id` (query, optional): ID игры.\n- `category_id` (query, optional): ID категории.\n- `q` (query, optional): Поиск по названию товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Текущий максимум: 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/products",
"host": [
"{{base_url}}"
],
"path": [
"products"
],
"query": [
{
"key": "type",
"value": "topup",
"description": "voucher или topup.",
"disabled": true
},
{
"key": "game",
"value": "PUBG",
"description": "Частичный поиск по названию игры.",
"disabled": true
},
{
"key": "category",
"value": "Global",
"description": "Частичный поиск по названию категории.",
"disabled": true
},
{
"key": "game_id",
"value": "1",
"description": "ID игры.",
"disabled": true
},
{
"key": "category_id",
"value": "10",
"description": "ID категории.",
"disabled": true
},
{
"key": "q",
"value": "60 UC",
"description": "Поиск по названию товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Текущий максимум: 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Неверный фильтр или параметр пагинации.\"\n }\n}"
}
]
}
]
},
{
"name": "Проверка",
"description": "Проверка",
"item": [
{
"name": "POST /validate-player",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"nickname\": \"PlayerOne\",\n \"player_name\": \"PlayerOne\",\n \"region\": \"TR\",\n \"country\": \"TR\",\n \"server\": \"1234\",\n \"nickname_verified\": true,\n \"validation_optional\": false\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Обязательное поле тела отсутствует или имеет неверный формат.\"\n }\n}"
},
{
"name": "PRODUCT_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"PRODUCT_NOT_FOUND\",\n \"message\": \"Товар пополнения не найден или неактивен.\"\n }\n}"
},
{
"name": "PLAYER_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет ID игрока и при необходимости ID сервера.\n\nЕсли проверка необязательна, может вернуться validation_optional=true.\n\n## Parameters\n- `product_id` (body, required): ID товара пополнения.\n- `player_id` (body, required): ID игрока.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Обязательное поле тела отсутствует или имеет неверный формат.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар пополнения не найден или неактивен.\n- `PLAYER_NOT_FOUND` HTTP 404: Игрок не прошёл обязательную проверку.",
"url": {
"raw": "{{base_url}}/validate-player",
"host": [
"{{base_url}}"
],
"path": [
"validate-player"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"PLAYER_NOT_FOUND\",\n \"message\": \"Игрок не прошёл обязательную проверку.\"\n }\n}"
}
]
}
]
},
{
"name": "Заказы",
"description": "Заказы",
"item": [
{
"name": "POST /order",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"order_id\": 8821,\n \"order_uuid\": \"a80f63d7-cabb-4e1d-a177-045f6467e7b2\",\n \"client_order_id\": \"order-10001\",\n \"product_id\": 91,\n \"product_name\": \"PUBG Mobile 60 UC\",\n \"product_type\": \"TOPUP\",\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"player_name\": \"PlayerOne\",\n \"region\": \"TR\",\n \"status\": \"PROCESSING\",\n \"price\": \"0.8800\",\n \"currency\": \"USD\",\n \"delivery\": null,\n \"manual_action_required\": false,\n \"delivery_message\": null,\n \"created_at\": \"2026-07-25T13:30:00+04:00\",\n \"completed_at\": null\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Одно из полей тела запроса неверно.\"\n }\n}"
},
{
"name": "PRODUCT_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"PRODUCT_NOT_FOUND\",\n \"message\": \"Товар не найден или неактивен.\"\n }\n}"
},
{
"name": "INVALID_QUANTITY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_QUANTITY\",\n \"message\": \"Количество превышает лимит товара или API.\"\n }\n}"
},
{
"name": "PLAYER_ID_REQUIRED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"PLAYER_ID_REQUIRED\",\n \"message\": \"Для пополнения требуется player_id.\"\n }\n}"
},
{
"name": "SERVER_ID_REQUIRED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"SERVER_ID_REQUIRED\",\n \"message\": \"Для товара требуется server_id.\"\n }\n}"
},
{
"name": "PLAYER_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"PLAYER_NOT_FOUND\",\n \"message\": \"Обязательная проверка игрока не пройдена.\"\n }\n}"
},
{
"name": "INSUFFICIENT_FUNDS",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INSUFFICIENT_FUNDS\",\n \"message\": \"Недостаточно средств для заказа.\"\n }\n}"
},
{
"name": "OUT_OF_STOCK",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 409,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"OUT_OF_STOCK\",\n \"message\": \"Не удалось создать или обработать заказ.\"\n }\n}"
},
{
"name": "IDEMPOTENCY_KEY_REQUIRED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IDEMPOTENCY_KEY_REQUIRED\",\n \"message\": \"Для этой операции требуется стабильный ключ идемпотентности.\"\n }\n}"
},
{
"name": "IDEMPOTENCY_KEY_INVALID",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IDEMPOTENCY_KEY_INVALID\",\n \"message\": \"Ключ идемпотентности недействителен или длиннее 128 символов.\"\n }\n}"
},
{
"name": "IDEMPOTENCY_CONFLICT",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 409,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IDEMPOTENCY_CONFLICT\",\n \"message\": \"Один ключ использован с другим содержимым запроса.\"\n }\n}"
},
{
"name": "CLIENT_ORDER_ID_CONFLICT",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 409,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"CLIENT_ORDER_ID_CONFLICT\",\n \"message\": \"Этот client_order_id уже назначен другому заказу.\"\n }\n}"
},
{
"name": "SECURITY_ERROR",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"SECURITY_ERROR\",\n \"message\": \"URL обратного вызова не соответствует требованиям безопасности.\"\n }\n}"
},
{
"name": "ORDER_FAILED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{order_idempotency_key}}",
"type": "text",
"description": "Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Создаёт ваучерный заказ или пополнение и списывает сумму с баланса.\n\nЭтот адрес создаёт реальную финансовую операцию. Используйте X-Idempotency-Key для повторных запросов.\n\n## Parameters\n- `X-Idempotency-Key` (header, optional): Уникальный ключ повтора. Обязателен для операций, меняющих баланс; для POST /order client_order_id может использоваться как резервный ключ.\n- `product_id` (body, required): ID активного товара.\n- `qty` (body, optional): Максимум ваучеров: 500; максимум пополнений: 1.\n- `player_id` (body, optional): Обязательно для пополнения.\n- `server_id` (body, optional): ID сервера или зоны, если требуется.\n- `input_2...input_8` (body, optional): Дополнительные значения input_2...input_8 согласно списку fields продукта.\n- `client_order_id` (body, optional): Ваш собственный идентификатор заказа. Если в POST /order нет X-Idempotency-Key, это значение также используется как ключ повтора.\n- `callback_url` (body, optional): Безопасный HTTPS URL обратного вызова.\n- `callback_mode` (body, optional): Формат обратного вызова. По умолчанию: legacy.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Одно из полей тела запроса неверно.\n- `PRODUCT_NOT_FOUND` HTTP 404: Товар не найден или неактивен.\n- `INVALID_QUANTITY` HTTP 422: Количество превышает лимит товара или API.\n- `PLAYER_ID_REQUIRED` HTTP 422: Для пополнения требуется player_id.\n- `SERVER_ID_REQUIRED` HTTP 422: Для товара требуется server_id.\n- `PLAYER_NOT_FOUND` HTTP 404: Обязательная проверка игрока не пройдена.\n- `INSUFFICIENT_FUNDS` HTTP 400: Недостаточно средств для заказа.\n- `OUT_OF_STOCK` HTTP 409: Не удалось создать или обработать заказ.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `CLIENT_ORDER_ID_CONFLICT` HTTP 409: Этот client_order_id уже назначен другому заказу.\n- `SECURITY_ERROR` HTTP 400: URL обратного вызова не соответствует требованиям безопасности.\n- `ORDER_FAILED` HTTP 409: Не удалось создать или обработать заказ.",
"url": {
"raw": "{{base_url}}/order",
"host": [
"{{base_url}}"
],
"path": [
"order"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"product_id\": 91,\n \"qty\": 1,\n \"player_id\": \"51515969536\",\n \"server_id\": \"1234\",\n \"input_3\": \"CharacterName\",\n \"client_order_id\": \"{{client_order_id}}\",\n \"callback_url\": \"{{callback_url}}\",\n \"callback_mode\": \"{{callback_mode}}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 409,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_FAILED\",\n \"message\": \"Не удалось создать или обработать заказ.\"\n }\n}"
}
]
},
{
"name": "GET /order/{id}/qr-login/status",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"order_id\": 8821,\n \"order_status\": \"PROCESSING\",\n \"session_status\": \"QR_READY\",\n \"status_label\": \"QR code is ready.\",\n \"has_qr\": true,\n \"qr_version\": 1,\n \"qr_image_url\": \"https://gmx.az/api/v1/order/8821/qr-login/preview?v=1\",\n \"expires_at\": \"2026-08-17T16:30:00+04:00\",\n \"can_mark_scanned\": true,\n \"can_request_new_qr\": true,\n \"can_submit_otp\": false,\n \"is_final\": false\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее состояние QR Login для своего заказа.\n\nВозвращает наличие QR, версию, состояние оператора, срок действия и разрешённые действия.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/status",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"status"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден или принадлежит другому API пользователю.\"\n }\n}"
}
]
},
{
"name": "GET /order/{id}/qr-login/preview",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "\"Бинарный ответ image/jpeg.\""
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Получить текущее активное QR-изображение.\n\nВозвращает приватный JPEG только пока QR активен. Используйте тот же API-ключ. Обычный тег ![]()
не может отправить X-API-KEY, поэтому загрузите изображение авторизованным binary/blob-запросом и покажите полученный object URL.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `v` (query, optional): Необязательная версия QR для обхода кеша.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/preview",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"preview"
],
"query": [
{
"key": "v",
"value": "1",
"description": "Необязательная версия QR для обхода кеша.",
"disabled": true
}
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден или принадлежит другому API пользователю.\"\n }\n}"
}
]
},
{
"name": "POST /order/{id}/qr-login/scanned",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"session_status\": \"customer_scanned\",\n \"has_qr\": true\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сообщить назначенному оператору, что клиент отсканировал активный QR.\n\nИспользуйте только после реального сканирования QR клиентом. Это не завершает заказ автоматически.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/scanned",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"scanned"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден или принадлежит другому API пользователю.\"\n }\n}"
}
]
},
{
"name": "POST /order/{id}/qr-login/new-qr",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"session_status\": \"awaiting_new_qr\",\n \"has_qr\": false\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Сделать текущий QR недействительным и запросить замену.\n\nИспользуйте если QR истёк или не сканируется.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/new-qr",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"new-qr"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден или принадлежит другому API пользователю.\"\n }\n}"
}
]
},
{
"name": "POST /order/{id}/qr-login/otp",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"session_status\": \"customer_scanned\",\n \"has_qr\": true\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"OTP должен содержать 4-10 цифр.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Отправить одноразовый код, запрошенный назначенным оператором.\n\nOTP принимается только на этапе awaiting_otp и передаётся оператору без сохранения в базе.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n- `otp` (body, required): Одноразовый код из 4-10 цифр.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: OTP должен содержать 4-10 цифр.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}/qr-login/otp",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}",
"qr-login",
"otp"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
},
"body": {
"mode": "raw",
"raw": "{\n \"otp\": \"123456\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден или принадлежит другому API пользователю.\"\n }\n}"
}
]
},
{
"name": "GET /order/{id}",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"order_id\": 8821,\n \"order_uuid\": \"a80f63d7-cabb-4e1d-a177-045f6467e7b2\",\n \"client_order_id\": \"order-10001\",\n \"product_id\": 17,\n \"product_name\": \"Steam Wallet 10 USD\",\n \"product_type\": \"VOUCHER\",\n \"qty\": 2,\n \"player_id\": null,\n \"server_id\": null,\n \"player_name\": null,\n \"region\": null,\n \"status\": \"COMPLETED\",\n \"price\": \"19.9800\",\n \"currency\": \"USD\",\n \"delivery\": [\n \"CODE-ONE-XXXX\",\n \"CODE-TWO-XXXX\"\n ],\n \"manual_action_required\": false,\n \"delivery_message\": null,\n \"created_at\": \"2026-07-25T13:30:00+04:00\",\n \"completed_at\": \"2026-07-25T13:31:10+04:00\"\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Находит заказ по ID, UUID или client_order_id.\n\nВозвращает текущий статус и коды выдачи ваучера, если они доступны.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден или принадлежит другому API пользователю.",
"url": {
"raw": "{{base_url}}/order/{{order_id}}",
"host": [
"{{base_url}}"
],
"path": [
"order",
"{{order_id}}"
],
"variable": [
{
"key": "order_id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден или принадлежит другому API пользователю.\"\n }\n}"
}
]
},
{
"name": "GET /order-status/{id}",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"order_id\": 8821,\n \"status\": \"COMPLETED\",\n \"delivery\": [\n \"CODE-ONE-XXXX\"\n ],\n \"manual_action_required\": false,\n \"delivery_message\": null\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "ORDER_NOT_FOUND",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Совместимый адрес для /order/{id}.\n\nДля новых интеграций используйте /order/{id}.\n\n## Parameters\n- `id` (path, required): Order ID, order_uuid или client_order_id.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `ORDER_NOT_FOUND` HTTP 404: Заказ не найден.",
"url": {
"raw": "{{base_url}}/order-status/{{id}}",
"host": [
"{{base_url}}"
],
"path": [
"order-status",
"{{id}}"
],
"variable": [
{
"key": "id",
"value": "8821"
}
]
}
},
"status": "Error",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"ORDER_NOT_FOUND\",\n \"message\": \"Заказ не найден.\"\n }\n}"
}
]
},
{
"name": "GET /orders",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": [\n {\n \"order_id\": 8821,\n \"product_name\": \"Steam Wallet 10 USD\",\n \"product_type\": \"VOUCHER\",\n \"qty\": 1,\n \"status\": \"COMPLETED\",\n \"price\": \"9.9900\",\n \"currency\": \"USD\",\n \"delivery\": [\n \"CODE-ONE-XXXX\"\n ],\n \"manual_action_required\": false,\n \"delivery_message\": null\n }\n ],\n \"meta\": {\n \"current_page\": 1,\n \"last_page\": 1,\n \"per_page\": 50,\n \"total\": 1\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
}
],
"description": "Возвращает заказы текущего API пользователя с фильтрами и пагинацией.\n\nКлиент может видеть только свои заказы. Максимум per_page — 100.\n\n## Parameters\n- `status` (query, optional): Статус заказа.\n- `type` (query, optional): Тип товара.\n- `page` (query, optional): Номер страницы.\n- `per_page` (query, optional): Размер страницы. Максимум 100.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `VALIDATION_ERROR` HTTP 422: Неверный фильтр или параметр пагинации.",
"url": {
"raw": "{{base_url}}/orders",
"host": [
"{{base_url}}"
],
"path": [
"orders"
],
"query": [
{
"key": "status",
"value": "completed",
"description": "Статус заказа.",
"disabled": true
},
{
"key": "type",
"value": "voucher",
"description": "Тип товара.",
"disabled": true
},
{
"key": "page",
"value": "1",
"description": "Номер страницы.",
"disabled": true
},
{
"key": "per_page",
"value": "50",
"description": "Размер страницы. Максимум 100.",
"disabled": true
}
]
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Неверный фильтр или параметр пагинации.\"\n }\n}"
}
]
}
]
},
{
"name": "Проверка кода",
"description": "Проверка кода",
"item": [
{
"name": "POST /redeem-check",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"response": [
{
"name": "Пример успешного ответа",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"data\": {\n \"id\": 142,\n \"status\": \"found\",\n \"code_masked\": \"REDE********MPLE\",\n \"charged_amount\": \"0.0500\",\n \"charged_amount_text\": \"$ 0.05\",\n \"balance\": \"1250.4500\",\n \"balance_text\": \"$ 1250.45\",\n \"currency_code\": \"USD\",\n \"currency_symbol\": \"$\",\n \"redemption_time\": \"2026-07-25 13:30:00\",\n \"expiration_time\": null,\n \"amount\": 60,\n \"product_name\": \"PUBG Mobile 60 UC\",\n \"player_id\": \"51515969536\",\n \"player_name\": \"PlayerOne\",\n \"created_at\": \"2026-07-25 13:30:02\"\n },\n \"meta\": {\n \"idempotent_replay\": false\n }\n}"
},
{
"name": "API_DISABLED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 503,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_DISABLED\",\n \"message\": \"Public API отключён администратором.\"\n }\n}"
},
{
"name": "API_KEY_MISSING",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"API_KEY_MISSING\",\n \"message\": \"Заголовок X-API-KEY не передан.\"\n }\n}"
},
{
"name": "INVALID_API_KEY",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_API_KEY\",\n \"message\": \"API ключ недействителен или отключён, либо клиент неактивен.\"\n }\n}"
},
{
"name": "IP_NOT_ALLOWED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IP_NOT_ALLOWED\",\n \"message\": \"IP адрес запроса не разрешён.\"\n }\n}"
},
{
"name": "RATE_LIMIT_EXCEEDED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 429,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"RATE_LIMIT_EXCEEDED\",\n \"message\": \"Превышен лимит запросов в минуту.\"\n }\n}"
},
{
"name": "IDEMPOTENCY_KEY_REQUIRED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IDEMPOTENCY_KEY_REQUIRED\",\n \"message\": \"Для этой операции требуется стабильный ключ идемпотентности.\"\n }\n}"
},
{
"name": "IDEMPOTENCY_KEY_INVALID",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IDEMPOTENCY_KEY_INVALID\",\n \"message\": \"Ключ идемпотентности недействителен или длиннее 128 символов.\"\n }\n}"
},
{
"name": "IDEMPOTENCY_CONFLICT",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 409,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"IDEMPOTENCY_CONFLICT\",\n \"message\": \"Один ключ использован с другим содержимым запроса.\"\n }\n}"
},
{
"name": "VALIDATION_ERROR",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"VALIDATION_ERROR\",\n \"message\": \"Код отсутствует или имеет неверную длину.\"\n }\n}"
},
{
"name": "REDEEM_CHECK_FAILED",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json",
"type": "text"
},
{
"key": "X-Idempotency-Key",
"value": "{{redeem_idempotency_key}}",
"type": "text",
"description": "Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.",
"disabled": false
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"description": "Проверяет код и списывает сумму, соответствующую результату.\n\nЭтот адрес создаёт реальную операцию с балансом. Неиспользованная часть резерва возвращается.\n\n## Parameters\n- `X-Idempotency-Key` (header, required): Обязательный уникальный ключ повтора. Повтор с тем же кодом возвращает исходный результат без повторного списания и повторной внешней проверки.\n- `code` (body, required): Проверяемый код. 6-160 символов.\n\n## Errors\n- `API_DISABLED` HTTP 503: Public API отключён администратором.\n- `API_KEY_MISSING` HTTP 401: Заголовок X-API-KEY не передан.\n- `INVALID_API_KEY` HTTP 401: API ключ недействителен или отключён, либо клиент неактивен.\n- `IP_NOT_ALLOWED` HTTP 403: IP адрес запроса не разрешён.\n- `RATE_LIMIT_EXCEEDED` HTTP 429: Превышен лимит запросов в минуту.\n- `IDEMPOTENCY_KEY_REQUIRED` HTTP 422: Для этой операции требуется стабильный ключ идемпотентности.\n- `IDEMPOTENCY_KEY_INVALID` HTTP 422: Ключ идемпотентности недействителен или длиннее 128 символов.\n- `IDEMPOTENCY_CONFLICT` HTTP 409: Один ключ использован с другим содержимым запроса.\n- `VALIDATION_ERROR` HTTP 422: Код отсутствует или имеет неверную длину.\n- `REDEEM_CHECK_FAILED` HTTP 422: Проверка кода не удалась, сервис отключён или недостаточно средств.",
"url": {
"raw": "{{base_url}}/redeem-check",
"host": [
"{{base_url}}"
],
"path": [
"redeem-check"
]
},
"body": {
"mode": "raw",
"raw": "{\n \"code\": \"REDEEM-CODE-EXAMPLE\"\n}",
"options": {
"raw": {
"language": "json"
}
}
}
},
"status": "Error",
"code": 422,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"error\": {\n \"code\": \"REDEEM_CHECK_FAILED\",\n \"message\": \"Проверка кода не удалась, сервис отключён или недостаточно средств.\"\n }\n}"
}
]
}
]
},
{
"name": "Webhooks",
"description": "Примеры приёмника webhook. Требования:\n- Принимаются только HTTPS URL.\n- Принимается только порт 443.\n- Частные, зарезервированные и localhost адреса блокируются.\n- Учётные данные в URL не принимаются.\n- Перенаправления не выполняются.\n- Сервер должен вернуть ответ 2xx.\n\nГрафик повторов: 1 → 1 минута, 2 → 5 минут, 3 → 15 минут, 4-6 → 60 минут, 7-20 → 6 часов",
"item": [
{
"name": "Пример финального webhook legacy",
"request": {
"auth": {
"type": "noauth"
},
"method": "POST",
"header": [
{
"key": "X-EPINBULK-Signature-V2",
"value": "sha256=CALCULATED_HMAC_V2",
"type": "text",
"description": "Рекомендуется: sha256=HMAC_SHA256(timestamp + \".\" + event_id + \".\" + raw_json_body, webhook_secret). Используйте заголовки timestamp и event-id, указанные выше."
},
{
"key": "X-EPINBULK-Signature-Version",
"value": "2",
"type": "text",
"description": "2"
},
{
"key": "X-EPINBULK-Signature",
"value": "sha256=CALCULATED_HMAC",
"type": "text",
"description": "sha256=HMAC_SHA256(сырое_тело_json, секрет_webhook)"
},
{
"key": "X-EPINBULK-Timestamp",
"value": "2026-09-27T12:18:14+00:00",
"type": "text",
"description": "Время отправки webhook в ISO-8601. При проверке подписи V2 проверяйте также актуальность времени."
},
{
"key": "X-EPINBULK-Event-Id",
"value": "{{$guid}}",
"type": "text",
"description": "Уникальный UUID попытки обратного вызова."
},
{
"key": "X-EPINBULK-Event",
"value": "order.status_changed",
"type": "text",
"description": "Actual event name: order.status_changed or qr_login.*"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"event_id\": \"47c8c6ba-16a5-4089-9f62-7ae1e51d4c0f\",\n \"order_id\": 8821,\n \"client_order_id\": \"order-10001\",\n \"status\": \"COMPLETED\",\n \"product_name\": \"Steam Wallet 10 USD\",\n \"qty\": 2,\n \"player_id\": null,\n \"player_name\": null,\n \"server_id\": null,\n \"region\": null,\n \"price\": \"19.9800\",\n \"currency\": \"USD\",\n \"delivery\": [\n \"CODE-ONE-XXXX\",\n \"CODE-TWO-XXXX\"\n ],\n \"manual_action_required\": false,\n \"delivery_message\": null,\n \"timestamp\": \"2026-07-25T13:31:10+04:00\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{callback_url}}",
"host": [
"{{callback_url}}"
]
},
"description": "Этот запрос показывает payload, который платформа отправляет на callback_url. Получатель должен проверить HMAC, обрабатывать event_id идемпотентно и быстро вернуть 2xx."
},
"response": []
},
{
"name": "Пример webhook events",
"request": {
"auth": {
"type": "noauth"
},
"method": "POST",
"header": [
{
"key": "X-EPINBULK-Signature-V2",
"value": "sha256=CALCULATED_HMAC_V2",
"type": "text",
"description": "Рекомендуется: sha256=HMAC_SHA256(timestamp + \".\" + event_id + \".\" + raw_json_body, webhook_secret). Используйте заголовки timestamp и event-id, указанные выше."
},
{
"key": "X-EPINBULK-Signature-Version",
"value": "2",
"type": "text",
"description": "2"
},
{
"key": "X-EPINBULK-Signature",
"value": "sha256=CALCULATED_HMAC",
"type": "text",
"description": "sha256=HMAC_SHA256(сырое_тело_json, секрет_webhook)"
},
{
"key": "X-EPINBULK-Timestamp",
"value": "2026-09-27T12:18:14+00:00",
"type": "text",
"description": "Время отправки webhook в ISO-8601. При проверке подписи V2 проверяйте также актуальность времени."
},
{
"key": "X-EPINBULK-Event-Id",
"value": "{{$guid}}",
"type": "text",
"description": "Уникальный UUID попытки обратного вызова."
},
{
"key": "X-EPINBULK-Event",
"value": "order.status_changed",
"type": "text",
"description": "Actual event name: order.status_changed or qr_login.*"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"event_id\": \"47c8c6ba-16a5-4089-9f62-7ae1e51d4c0f\",\n \"event\": \"order.status_changed\",\n \"callback_mode\": \"events\",\n \"order_id\": 8821,\n \"client_order_id\": \"order-10001\",\n \"product_id\": 91,\n \"product_name\": \"PUBG Mobile 60 UC\",\n \"product_type\": \"TOPUP\",\n \"game_id\": 1,\n \"game_name\": \"PUBG Mobile\",\n \"player_id\": \"51515969536\",\n \"player_name\": \"PlayerOne\",\n \"server_id\": \"1234\",\n \"region\": \"TR\",\n \"qty\": 1,\n \"price\": \"0.8800\",\n \"currency\": \"USD\",\n \"delivery\": [],\n \"manual_action_required\": false,\n \"delivery_message\": null,\n \"status\": \"COMPLETED\",\n \"message\": \"Заказ успешно завершён.\",\n \"timestamp\": \"2026-07-25T13:30:10+04:00\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{callback_url}}",
"host": [
"{{callback_url}}"
]
},
"description": "Этот запрос показывает payload, который платформа отправляет на callback_url. Получатель должен проверить HMAC, обрабатывать event_id идемпотентно и быстро вернуть 2xx."
},
"response": []
}
]
}
]
}