Skip to content

Пополнение карты ​

Ecom Gate — API для зачисления средств на банковскую карту клиента с баланса партнёра. API построено на REST, обмен сообщениями — по HTTP в формате JSON.

Порядок пополнения ​

  1. Информация о карте — проверьте карту и получите имя владельца.
  2. Создание транзакции — создайте операцию с уникальным ext и получите operationId.
  3. Подтверждение транзакции — подтвердите операцию по operationId.
  4. Проверка транзакции — узнайте итоговый статус по ext.

Остаток средств на вашем балансе можно узнать методом Баланс.

Аутентификация ​

Каждый запрос должен содержать HTTP-заголовок Authorization с типом Basic. Заголовки одинаковы для всех методов.

HeaderЗначение
AuthorizationBasic base64(login:password)
Content-Typeapplication/json

Формат ответа ​

Все методы возвращают ответ в едином формате. Запрос выполнен успешно, если code равен 0 и data не null.

json
{
  "data": {},
  "message": "",
  "code": 0,
  "timestamp": 1742816371550
}
#ParameterData typeDescription
1dataObjectДанные ответа, при ошибке — null
2messageStringСообщение (при ошибке — текст ошибки)
3codeIntegerКод ответа, 0 — успешно
4timestampLongВременная метка обработки запроса (Unix, мс)

Суммы ​

Все суммы передаются в тийинах: 10000 = 100 сум.

Подключение и безопасность ​

Обмен данными ведётся только через IPSec-туннель, который настраивается с обеих сторон. Адрес и порт промышленного API, а также логин и пароль выдаются при подключении.

Требования безопасности

Обе стороны обязаны обеспечивать защиту серверов, сети и безопасную передачу данных. При инцидентах стороны оперативно взаимодействуют для устранения угроз.

АК «Халқ банки» — платежная система Xazna