API выставления счета

API позволяет мерчанту создать заказ в Xazna и отправить клиенту счет на оплату по номеру телефона. После этого мерчант может проверить статус заказа и платежа.

Метод	Endpoint	Назначение
Создание заказа	POST /api/v1/billing/create/order	Создание заказа и отправка счета на номер телефона.
Проверка заказа	POST /api/v1/billing/check/order	Проверка статуса заказа.
Проверка платежа	GET /api/v1/billing/check/transaction	Проверка статуса транзакции по ее идентификатору.

Параметры подключения

Перед интеграцией Xazna предоставляет мерчанту:

1. Username и password — данные для аутентификации;
2. MerchantId — уникальный идентификатор мерчанта (merchantId);
3. Base URL — адрес API, например https://xazna.uz.

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

Все запросы выполняются с HTTP Basic-аутентификацией: в заголовке Authorization передаются логин и пароль в формате base64(username:password).

Authorization: Basic base64(username:password)
Content-Type: application/json
Accept: application/json

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

Все методы возвращают ответ в едином формате:

{
  "data": {
    "orderId": "string"
  },
  "errorMessage": "",
  "timestamp": 1753436810922
}

#	Параметр	Тип	Описание
1	data	Object	Результат запроса. При ошибке — null.
2	errorMessage	String	Текст ошибки. При успешном запросе — пустая строка.
3	timestamp	Long	Время ответа в миллисекундах.

Запрос выполнен успешно, если data не равно null, а errorMessage — пустая строка. Список ошибок приведен на странице Ошибки.

Суммы в тийинах

Все суммы (amount) передаются в тийинах: 1 сум = 100 тийин. Например, 100000 — это 1 000 сум.