Приложение Jetpay для Битрикс 24

В этой статье описан процесс установки и настройки приложения Jetpay для CMS-системы Битрикс 24. Это приложение позволяет проводить платежи с использованием платежных решений JetPay на сайтах, созданных на базе Битрикс 24.

Схема работы

Взаимодействие с платежными решениями JetPay осуществляется через платежную страницу Payment Page. Подробнее о Payment Page см. Payment Page.

Рис.: Схема проведения оплаты с использованием приложения Jetpay



Рис.: Проведение оплаты с использованием приложения Jetpay. Описание шагов

  1. Пользователь на стороне веб-сервиса инициирует оплату.
  2. В соответствии с параметрами работы платежной системы формируется запрос на открытие Payment Page.
  3. Запрос на открытие Payment Page поступает в платежную платформу.
  4. Выполняется начальная обработка запроса, в процессе которой проверяется наличие обязательных параметров и корректной подписи.
  5. Осуществляется подготовка Payment Page согласно параметрам проекта и вызова.
  6. Пользователю отображается платежная форма.
  7. Пользователь выполняет необходимые действия для оплаты.
  8. Запрос на проведение оплаты поступает в платежную платформу.
  9. Выполняются дальнейшая обработка запроса и его отправка в платежную среду.
  10. На стороне платежной среды выполняется обработка платежа.
  11. Платежная среда направляет в платежную платформу уведомление о результате оплаты.
  12. Платежная платформа направляет в Payment Page результат проведения оплаты.
  13. Информация о результате оплаты отображается пользователю на Payment Page.
  14. Платежная платформа направляет в веб-сервис оповещение о результате оплаты.
  15. Информация о результате оплаты отображается пользователю на стороне веб-сервиса.

Запросы на открытие платежной формы формируются автоматически средствами приложения Jetpay, если оно было ранее подключено на сайте магазина в Битрикс 24.

Подготовка к подключению приложения Jetpay

Перед началом установки Jetpay необходимо:
  1. Создать сайт-магазин на платформе Битрикс 24. Подробно о создании новых сайтов на Битрикс 24 рассказывается в документации Битрикс 24.
  2. Стать клиентом JetPay.

Чтобы стать клиентом JetPay:

  1. Подайте заявку на подключение, отправив на почту newmerchants@jetpay.kz письмо со следующей информацией о своей компании и сайте:
    • название компании;
    • название сайта;
    • основная валюта сайта.

После регистрации техническая поддержка сообщит следующую информацию, которая необходима, чтобы использовать ПС Jetpay:

  • Идентификатор проекта — уникальный идентификатор вашего магазина.
  • Секретный ключ — это ключ, который необходим для подписывания запросов на выполнение платежей.
  • Валюта — основная валюта магазина, которая будет автоматически использоваться при открытии платежной страницы.
  • Идентификатор платежного метода (необязательный параметр) — этот идентификатор можно указывать в запросе, если нужно, чтобы платежная страница открывалась с уже выбранным платежным методом.

Подключение и настройка приложения Jetpay

После завершения подготовки можно переходить к настройке приложения Jetpay на своем сайте.

Чтобы подключить ПС Jetpay для оплаты на сайте:

  1. Войдите в личный кабинет на сайте Битрикс 24 по адресу https://bitrix24.kz.
  2. В левой панели последовательно выберите Приложения > Маркет.
  3. На странице приложений выполните поиск по строке JetPay и найдите приложение Jetpay.


  4. Щелкните Посмотреть, чтобы открыть страницу информации о приложении.


  5. Щелчком Установить откройте диалоговое окно установки со списком прав, которые требуются приложению Jetpay.
  6. Ознакомьтесь с лицензионным соглашением и политикой конфиденциальности, подтвердите согласие, отметив соответствующие флажки, и щелкните Установить.


  7. Дождитесь окончания установки приложения и открытия окна с предложением настроить приложение Jetpay.


    Прим.: Следующие шаги инструкции доступны только клиентам JetPay.
  8. В окне с предложением настроить приложение Jetpay щелкните Да.
  10. В полях открывшегося окна введите следующие значения:
    • ID проекта (обязательный параметр) — полученный от JetPay идентификатор проекта;
    • Секретный ключ (обязательный параметр) — полученный от JetPay секретный ключ;
    • Валюта (обязательный параметр) — основная валюту магазина;
    • Дополнительные параметры (необязательный параметр) — другие параметры из спецификации API, разделенные символом &.


  11. Щелчком Сохранить сохраните изменения.

    Приложение Jetpay готово к работе и доступно как способ оплаты в ваших интернет-магазинах и сайтах.

При возникновении любых вопросов по установке и работе приложения Jetpay для Битрикс 24 обращайтесь к специалистам технической поддержки JetPay.