Введение

Инструкция описывает подключение мерчанта к биллинговой системе Xazna payment gateway: как перенаправить покупателя на платежную страницу и какие методы мерчант должен реализовать на своей стороне.

Кому подходит

Интеграция рассчитана на юридические лица, продающие товары или услуги пользователям, у которых есть собственная биллинговая система с доступным по HTTPS API.

Термины и определения

Термин	Определение
Платежная система Xazna	Платежная система электронной коммерции АК «Халқ банк», осуществляющая онлайн-платежи.
Пользователь	Физическое лицо, подключенное к платежной системе Xazna.
Интерфейс	Внешний вид системы, обеспечивающий взаимодействие пользователя с программой или устройством.
Merchant	Юридическое лицо, продающее товары или услуги пользователям.
Merchant billing	Автоматизированная система учета, тарификации и оплаты услуг, предоставляемых пользователю мерчантом.

Что нужно подготовить

1. merchantId — уникальный идентификатор, который выдается через Xazna.
2. Логин и пароль для Basic-аутентификации запросов, приходящих от Xazna в ваш биллинг.
3. Публичный HTTPS-эндпоинт, принимающий методы info, pay и check.

Порядок действий

1. Изучите схему взаимодействия — она показывает, кто кого вызывает и в какой момент.
2. Реализуйте три метода API в своем биллинге.
3. Добавьте на сайт кнопку оплаты Xazna.
4. Протестируйте оплату и обработку ошибок.

Единицы измерения

Суммы в разных местах передаются по-разному: в ссылке на платежную страницу — в сумах, а в ответе метода info — в тийинах. Проверяйте этот момент при интеграции.