Приложение для CMS Tamaranga

Расширение для CMS Tamaranga для интеграции с сервисом «Экспресс Платежи» через API. Расширение позволяет выставить счет в системе ЕРИП, получить и обработать уведомление о платеже в системе ЕРИП.

Версия расширения
1.0


Описание
Ниже на изображении представлен пример работы расширения в администраторской части CMS Tamaranga.
Приложение для CMS Tamaranga для приема платежей
Нажмите для увеличения

Инструкция по установке

Настройка приложения для работы с ЕРИП

Настройка приложения для работы с Интернет-эквайрингом

1.Настройка платежного модуля для работы с ЕРИП

1.1 Перейти в вкладку «Администрирование» на сайте.

1.2 Нажать на кнопку профиля «admin» => «Режим разработчика»(Рисунок 1).

Рисунок 1 – раздел «Режим разработчика»

Рисунок 1 – раздел «Режим разработчика»

1.3 Перейти в раздел «Дополнения» => «Плагины»(Рисунок 2).

Рисунок 2 – раздел «Плагины»

Рисунок 2 – раздел «Плагины»

1.4 Нажать кнопку «Создать плагин» (Рисунок 3).

Рисунок 3 – кнопка «Создать плагин»

Рисунок 3 – кнопка «Создать плагин»

1.5 Далее ввести «Название» Экспресс Платежи: ЕРИП, а также «Название(латиницей)» expresspay_erip(Рисунок 4).

Рисунок 4 – создание плагина

Рисунок 4 – создание плагина

1.6 После чего скопировать содержимое из скаченного архива директорию плагина /plugins/expresspay_erip.../

1.7 Перейти в раздел «Редактирование плагина»(Рисунок 5)

Рисунок 5 – раздел «Способы оплаты»

Рисунок 5 – раздел «Способы оплаты»

1.8 Настраиваем способ оплаты:

1.8.1 Настройка модуля, для работы в тестовом режиме:

1.8.1.1 Отмечаем пункт Тестовый режим

1.8.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

1.8.1.3 Поле «Секретное слово для цифровой подписи» заполняется только в том случае, если был выбран API ключ с параметрами «Применять цифровую подпись» и «Секретное слово».

1.8.1.4 Оставшиеся поля можно оставить без изменений, поскольку на работу модуля в тестовом режиме они не влияют.

1.8.2 Настройка модуля, для работы:

1.8.2.1 Убрать отметку в пунке Тестовый режим

1.8.2.2 Поля «API-ключ (токен) доступа к API» и «Номер услуги» заполнить значениями, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 6, Рисунок 7)

Рисунок 6 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 6 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 7 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»

Рисунок 7 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»

1.8.2.3 В разделе «Настройка» -> «Услуги» -> «API» личного кабинета сервиса «Экспресс Платежи» включите опцию «Применять цифровую подпись» и укажите значения в поле «Секретное слово». Значение из поля «Секретное слово» также следует указать в поле «Секретное слово для цифровой подписи» настройки приложения на вашем сайте.

1.8.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 8). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 9). Данная опция позволяет автоматически изменять статус заказа после оплаты.

Рисунок 8 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 8 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 9 – включение уведомлений об оплате на сайт

Рисунок 9 – включение уведомлений об оплате на сайт

1.8.2.5 Поля «Использовать цифровую подпись при получении уведомлений» и «Секретное слово для цифровой подписи уведомлений» используются для формирования цифровой подписи. Формирование цифровой подписи для передаваемых данных обеспечивает целостность информации и гарантирует, что передаваемые данные не были изменены посторонними лицами в процессе передачи.

При включении данной опции, значения в полях «Секретное слово для полученных уведомлений» в настройках приложения и «Секретное слово» в личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «Уведомления» должны быть одинаковыми.

1.8.2.6 Значение из поля «Путь ветки ЕРИП услуги» будет отображаться клиенту после формирования заказа и выставления счета в системе «Расчет» (Рисунок 10).

Рисунок 10 - путь ветки ЕРИП услуги при формировании заказа

Рисунок 10 - путь ветки ЕРИП услуги при формировании заказа

1.8.2.7 Включение опции «Разрешено изменять ФИО плательщика» позволяет плательщику изменять ФИО при оплате заказа в дереве ЕРИП.

1.8.2.8 Включение опции «Разрешено изменять адрес плательщика» позволяет плательщику изменять адрес при оплате заказа в дереве ЕРИП.

1.8.2.9 Включение опции «Разрешено изменять сумму оплаты» позволяет плательщику изменять сумму при оплате заказа в дереве ЕРИП.

1.8.2.10 Включение опции «Показывать Qr-код» позволяет отображать клиенту после формирования заказа Qr-код для оплаты в мобильных приложениях банка. (Рисунок 11)

Рисунок 11 - отображение Qr-кода для оплаты

Рисунок 11 - отображение Qr-кода для оплаты

1.8.4 После настройки плагина нажмите кнопку «Сохранить».

1.8.5 Перейти в раздел «Счета» => «Способы оплаты»(Рисунок 12)

Рисунок 12 – раздел «Способы оплаты»

Рисунок 12 – раздел «Способы оплаты»

1.8.6 Спуститься вниз страницы и заполнить необходимые поля, изображение способа оплаты находится в архиве (рисунок 13)

Рисунок 13 – создание способа оплаты

Рисунок 13 – создание способа оплаты

1.8.7 Нажмите кнопку «Добавить».

1.8.8 После добавления плагина нажмите кнопку «Сохранить».

2.Настройка платежного модуля для работы с Интернет-эквайрингом

2.1 Перейти в вкладку «Администрирование» на сайте.

2.2 Нажать на кнопку профиля «admin» => «Режим разработчика»(Рисунок 1).

Рисунок 1 – раздел «Режим разработчика»

Рисунок 1 – раздел «Режим разработчика»

2.3 Перейти в раздел «Дополнения» => «Плагины»(Рисунок 2).

Рисунок 2 – раздел «Плагины»

Рисунок 2 – раздел «Плагины»

2.4 Нажать кнопку «Создать плагин» (Рисунок 3).

Рисунок 3 – кнопка «Создать плагин»

Рисунок 3 – кнопка «Создать плагин»

2.5 Далее ввести «Название» Экспресс Платежи: ЕРИП, а также «Название(латиницей)» expresspay_erip(Рисунок 4).

Рисунок 4 – создание плагина

Рисунок 4 – создание плагина

2.6 После чего скопировать содержимое из скаченного архива директорию плагина /plugins/expresspay_erip.../

2.7 Перейти в раздел «Редактирование плагина»(Рисунок 5)

Рисунок 5 – раздел «Способы оплаты»

Рисунок 5 – раздел «Способы оплаты»

2.8 Настраиваем способ оплаты:

2.8.1 Настройка модуля, для работы в тестовом режиме:

2.8.1.1 Отмечаем пункт Тестовый режим

2.8.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox

2.8.1.3 Поле «Секретное слово для цифровой подписи» заполняется только в том случае, если был выбран API ключ с параметрами «Применять цифровую подпись» и «Секретное слово».

2.8.1.4 Оставшиеся поля можно оставить без изменений, поскольку на работу модуля в тестовом режиме они не влияют.

2.8.2 Настройка модуля, для работы:

2.8.2.1 Убрать отметку в пунке Тестовый режим

2.8.2.2 Поля «API-ключ (токен) доступа к API» и «Номер услуги» заполнить значениями, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 6, Рисунок 7)

Рисунок 6 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 6 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 7 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»

Рисунок 7 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»

2.8.2.3 В разделе «Настройка» -> «Услуги» -> «API» личного кабинета сервиса «Экспресс Платежи» включите опцию «Применять цифровую подпись» и укажите значения в поле «Секретное слово». Значение из поля «Секретное слово» также следует указать в поле «Секретное слово для цифровой подписи» настройки приложения на вашем сайте.

2.8.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 8). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 9). Данная опция позволяет автоматически изменять статус заказа после оплаты.

Рисунок 8 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 8 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»

Рисунок 9 – включение уведомлений об оплате на сайт

Рисунок 9 – включение уведомлений об оплате на сайт

2.8.2.5 Поля «Использовать цифровую подпись при получении уведомлений» и «Секретное слово для цифровой подписи уведомлений» используются для формирования цифровой подписи. Формирование цифровой подписи для передаваемых данных обеспечивает целостность информации и гарантирует, что передаваемые данные не были изменены посторонними лицами в процессе передачи.

При включении данной опции, значения в полях «Секретное слово для полученных уведомлений» в настройках приложения и «Секретное слово» в личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «Уведомления» должны быть одинаковыми.

2.8.4 После настройки плагина нажмите кнопку «Сохранить».

2.8.5 Перейти в раздел «Счета» => «Способы оплаты»(Рисунок 12)

Рисунок 12 – раздел «Способы оплаты»

Рисунок 12 – раздел «Способы оплаты»

2.8.6 Спуститься вниз страницы и заполнить необходимые поля, изображение способа оплаты находится в архиве (рисунок 13)

Рисунок 13 – создание способа оплаты

Рисунок 13 – создание способа оплаты

2.8.7 Нажмите кнопку «Добавить».

2.8.8 После добавления плагина нажмите кнопку «Сохранить».