Skip to content

API мерчанта

Для работы схемы, описанной на странице взаимодействия, мерчант реализует на своей стороне три метода. Все они принимаются на одном эндпоинте по протоколу JSON-RPC 2.0.

МетодНазначение
get.infoПолучение информации о счете на оплату.
payОплата счета.
checkПроверка статуса транзакции.

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

http
Auth: Basic (Username & password for authentication)
Content-Type: application/json
Accept: application/json

Логин и пароль согласуются с Xazna при подключении. Все запросы приходят методом POST на один адрес, например https://example.uz/api/.

Формат запроса

json
{
  "jsonrpc": "2.0",
  "method": "get.info",
  "id": "1234",
  "params": {}
}
#ПараметрТипОписание
1jsonrpcStringСтатический, всегда "2.0".
2methodStringНаименование метода.
3idStringСтатический идентификатор запроса.
4paramsObjectПараметры конкретного метода.

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

Успешный ответ содержит объект result, ответ с ошибкой — result: null и объект error. Подробнее — на странице Ошибки.

Рекомендация

Эндпоинт должен отвечать по HTTPS с валидным сертификатом и укладываться в разумное время ответа. Долгий ответ на pay увеличивает риск повторного вызова со стороны Xazna.

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