TEC.DELIVERY
enkkru

Настройка платежного плагина XPayment.kz

Создание способа оплаты и подключение платежной системы XPayment.kz.

Данная инструкция описывает процесс создания способа оплаты, подключения плагина XPayment.kz, настройки необходимых параметров и проверки корректности работы платежей в системе Tec.Delivery.

Подготовка

Необходимые данные

Перед началом настройки убедитесь, что у вас есть доступ к личному кабинету XPayment и получен API-токен.

Полное руководство по подключению: от Kaspi до первого платежа

В инструкции описано, как зарегистрироваться в XPayment, получить API-токен, подключить Kaspi и другие методы оплаты, а также настроить вебхуки для работы с платежами. Рекомендуется пройти этот гайд перед настройкой плагина.

Параметр Описание Пример
Аккаунт XPayment Аккаунт мерчанта для приема платежей merchant@company.kz
API Token Токен доступа, выданный системой XPayment xp_live_xxxxxxxxxxxx
Доступ в Tec.Delivery Учетная запись администратора системы Administrator
Настройка

Создание способа оплаты

Перейдите в раздел создания нового способа оплаты.

Виды оплаты → Добавить
Создание способа оплаты

Заполните основные параметры способа оплаты.

Параметр Описание Пример
Статус Включает или отключает способ оплаты Включен
Название вида оплаты Название, отображаемое пользователям в приложении Kaspi
Комиссия Фиксированная сумма или процент, добавляемый к заказу
Логотип Логотип платежной системы Kaspi Logo

Дополнительные настройки

Параметр Описание Рекомендуемое значение
Доступно для администраторов Позволяет операторам выбирать данный способ оплаты при создании заказа Включено
Доступно в приложении Отображает способ оплаты клиентам Включено
Интерфейс сдачи Интерфейс расчета сдачи для наличных платежей Выключено
Для онлайн-платежей параметр «Интерфейс сдачи» должен быть всегда выключен.

Настройка платежного плагина

Откройте вкладку настройки платежной системы.

Виды оплаты → Pay System
Настройка платежного плагина
Параметр Описание Рекомендуемое значение
Get Paylink Генерация платежной ссылки для клиента Включено
Emit URL URL для обработки уведомлений и запросов платежной системы https://api.tec.delivery/app/Pay/XPayment_kz/
Plugin Выбранный платежный модуль XPayment.kz
Token API-токен, полученный в личном кабинете XPayment xp_live_xxxxxxxxxxxx
Поле Emit URL заполняется автоматически и обычно не требует изменений. Если значение не было подставлено автоматически, скопируйте рекомендуемое значение.
Перед настройкой рекомендуется ознакомиться с официальным руководством XPayment по регистрации, получению API-токена.

XPayment

Полное руководство по подключению: от Kaspi до первого платежа

В инструкции описано, как зарегистрироваться в XPayment, получить API-токен, подключить Kaspi и другие методы оплаты, а также настроить вебхуки для работы с платежами. Рекомендуется пройти этот гайд перед настройкой плагина.

Тестирование

Проверка работы платежей

После сохранения настроек создайте тестовый заказ и выполните оплату.

Проверка Ожидаемый результат Пример
Отображение способа оплаты Способ оплаты доступен при оформлении заказа XPayment Online отображается в приложении
Генерация платежной ссылки Открывается страница оплаты XPayment Переход на платежную форму
Успешная оплата Статус заказа обновляется автоматически Заказ получает статус «Оплачен»
Важные замечания
API-токен является конфиденциальным параметром и не должен передаваться третьим лицам.
Если способ оплаты отключен, пользователи не смогут использовать его при оформлении заказа.
Для онлайн-платежей параметр «Интерфейс сдачи» должен оставаться выключенным.
После любых изменений рекомендуется выполнить тестовую оплату перед использованием платежной системы в рабочем режиме.

Чеклист