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": {}
}| # | Параметр | Тип | Описание |
|---|---|---|---|
| 1 | jsonrpc | String | Статический, всегда "2.0". |
| 2 | method | String | Наименование метода. |
| 3 | id | String | Статический идентификатор запроса. |
| 4 | params | Object | Параметры конкретного метода. |
Формат ответа
Успешный ответ содержит объект result, ответ с ошибкой — result: null и объект error. Подробнее — на странице Ошибки.
Рекомендация
Эндпоинт должен отвечать по HTTPS с валидным сертификатом и укладываться в разумное время ответа. Долгий ответ на pay увеличивает риск повторного вызова со стороны Xazna.