Приложение Kaspi QR для МойСклад
Разработчик: UnitLab moysklad.unitlab.pro
Поддержка: support@unitlab.pro, https://t.me/unitlab_bot
Общие сведения
Приложение реализует логику интеграции платежной системы Kaspi QR, позволяет генерировать ссылки на оплату через QR-код в системе МойСклад, обновляет статусы платежей, позволяет осуществлять возврат средств покупателю из МойСклад.
Основные возможности
- Генерация ссылки на оплату через приложение Kaspi Pay из документа "Заказ покупателя" в МойСклад
- Передача факта успешной оплаты в МойСклад со сменой статуса документа
- Создание документа "Входящий платеж" при успешной оплате
- Возврат оплаты покупателю из МойСклад
Технические особенности
Со стороны Kaspi используется схема с усиленной безопасностью. В данном варианте авторизация запросов к API Kaspi происходит по клиентскому сертификату. Возврат платежей по API происходит без участия покупателя.
Основные настройки
В данном разделе представлена общая информация о необходимых для работы приложения настройках.
Интеграции
Приложение позволяет работать с несколькими подключениями Kaspi, для этого необходимо подключить тариф "Корпоративный". На других тарифах доступна только 1 интеграция.
Для каждой интеграции на вкладке "Общее" необходимо заполнить следующие данные:
- Название магазина. Отображается на странице оплаты для клиента, укажите название юридического лица/бренда/адрес сайта.
- Органзация МойСклад. Выбирается из списка доступных организаций в системе. В дальнейшем в документах "Заказ покупателя" для этой организации будет доступна генерация ссылок на оплату.
- БИН юридического лица, зарегистрированого в Kaspi.
- Сертификат для доступа к API Kaspi. Создается в отдельном разделе "Сертификаты", будет рассмотрен подробнее далее.
- Торговая точка Kaspi. Выбирается из списка доступных торговых точек, созданных в Kaspi. Данное поле становится доступным к заполнению после активации вашего сертификата на стороне Kaspi.
На вкладке "Оплаты" указываются опции логики для успешной оплаты клиентом:
Сертификаты
Сертификаты используются для получения доступа к API Kaspi. У вас может быть несколько сертификатов для разных юридических лиц. Для работы приложения необходим как минимум 1 сертификат.
При создании сертификата необходимо заполнить следующие данные:
- Название сертификата. Произвольный текст для идентификации сертификата в списке.
- Регион. Название региона, где расположена ваша органиация, на английском языке.
- Населенный пункт. Название населенного пункта, где расположена ваша органиация, на английском языке.
- Компания. Юридическое название вашей организации, на английском языке.
- Контактный Email. Адрес электронной почты контактного лица вашей организации.
После созданиия сертификата в списке сертификатов необходимо скачать файл certrequest.csr. Дайнный файл необходимо отправить на адрес электронной почты cert.request@kaspi.kz с адреса электронной почты, указанного в вашем договоре с Kaspi. В тексте письма укажите, что вам необходим доступ к API Kaspi по схеме №3 (генерация QR и возвраты без участия покупателя).
В ответном письме от Kaspi вам поступит подтверждение о выпуске сертификата. С этого момента сертификат считается активным и может использоваться для запросов к API Kaspi. На стороне приложения происходит автоматическая проверка активности сертификатов каждый час. Если по истечении 1 часа после получения подтверждения от Kaspi ваш сертификат в настройках приложения не отображается активным, обратитесь в поддержку приложения.
После активации сертификата необходимо зайти в настройки приложения, на вкладке "Интеграции" перейти в редактирование нужной интеграции и указать сертификат, если он не был выбран ранее. После выбора сертификата и сохранения инетграции будет загружен список доступных торговых точек. Выбрите нужную торгову точку и сохраните настройки.
Работа со ссылками
После активации сертификата вы можете создавать ссылки в документе "Заказ покупателя". При нажатии кнопки "Создать ссылку" будет сгенерирована новая ссылка. Вы увидите сумму платежа и текущий статус.
Готовую ссылку можно скопировать или отменить. При нажатии кнопки "Скопировать" ссылка будет сохранена в буфере обмена. Отправьте ее клиенту для оплаты. При нажатии на кнопку "Отменить" ссылка будет удалена и вы сможете сгенерировать новую.
После оплаты клиентом статус у ссылки будет изменен на "Оплачен". В данном статусе появляется кнопка "Возврат". При нажатии будет произведен возврат оплаты клиенту.
Поддержка
Если у вас есть вопросы по работе приложения или пожелания по его доработке, пишите нам:
На электронную почту support@unitlab.pro
В телеграм https://t.me/unitlab_bot
При обращении в техподдержку, пожалуйста, предоставьте ID приложения, который вы можете найти в настройках приложения на вкладке "Поддержка".