Приложение Kaspi QR для МойСклад

Разработчик: UnitLab moysklad.unitlab.pro

Поддержка: support@unitlab.pro, https://t.me/unitlab_bot

Общие сведения

Приложение реализует логику интеграции платежной системы Kaspi QR, позволяет генерировать ссылки на оплату через QR-код в системе МойСклад, обновляет статусы платежей, позволяет осуществлять возврат средств покупателю из МойСклад.

Основные возможности

  1. Генерация ссылки на оплату через приложение Kaspi Pay из документа "Заказ покупателя" в МойСклад
  2. Передача факта успешной оплаты в МойСклад со сменой статуса документа
  3. Создание документа "Входящий платеж" при успешной оплате
  4. Возврат оплаты покупателю из МойСклад

Технические особенности

Со стороны 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 приложения, который вы можете найти в настройках приложения на вкладке "Поддержка".