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

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

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


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

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

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

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

Настройка приложения для работы с EPOS

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

1.1 Скопировать папки из архива корневую директорию сайта.

1.2 Перейти в административную часть сайта.

1.3 Перейти в раздел "Оплаты" => "Методы оплаты" (Рисунок 1).

Рисунок 1 – раздел «Методы оплаты»

Рисунок 1 – раздел «Методы оплаты»

1.4 Нажать кнопку «Добавить» (Рисунок 2).

Рисунок 2 – кнопка «Добавить»

Рисунок 2 – кнопка «Добавить»

1.5 Настраиваем метод оплаты:

1.5.1 В качестве платежной системы выбрать Экспресс Платежи - ЕРИП для установки оплаты через систему «Расчет» (АИС ЕРИП) (Рисунок 3).

Рисунок 3 – платежные системы

Рисунок 3 – платежные системы

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

1.5.2.1 Установите флажок в поле «Работа в тестовом режиме».

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

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

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

Рисунок 4 – настройка новой платежной системы в тестовом режиме

Рисунок 4 – настройка новой платежной системы в тестовом режиме

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

1.5.3.1 Убрать флажок в поле «Работа в тестовом режиме».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.5.3.11 Включение опции «Отсылать уведомления плательщикам по SMS» позволяет отсылать уведомления об оплате на номер телефона указанный при формировании заказа.

1.5.3.12 Включение опции «Отсылать уведомления плательщикам по электронной почте» позволяет отсылать уведомления об оплате на адрес электронной почты указанный при формировании заказа.

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

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

2.1 Скопировать папки из архива корневую директорию сайта.

2.2 Перейти в административную часть сайта.

2.3 Перейти в раздел "Оплаты" => "Методы оплаты" (Рисунок 1).

Рисунок 1 – раздел «Методы оплаты»

Рисунок 1 – раздел «Методы оплаты»

2.4 Нажать кнопку «Добавить» (Рисунок 2).

Рисунок 2 – кнопка «Добавить»

Рисунок 2 – кнопка «Добавить»

2.5 Настраиваем метод оплаты:

2.5.1 В качестве платежной системы выбрать Экспресс Платежи - Интернет-эквайринг для установки модуля оплаты через систему интернет-эквайринга (Рисунок 3).

Рисунок 3 – платежные системы

Рисунок 3 – платежные системы

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

2.5.2.1 Установите флажок в поле «Работа с тестовым стендом».

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

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

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

Рисунок 4 – настройка новой платежной системы в тестовом режиме

Рисунок 4 – настройка новой платежной системы в тестовом режиме

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

2.5.3.1 Убрать флажок в поле «Работа в тестовом режиме».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.Настройка платежного модуля для работы с EPOS

3.1 Скопировать папки из архива корневую директорию сайта.

3.2 Перейти в административную часть сайта.

3.3 Перейти в раздел "Оплаты" => "Методы оплаты" (Рисунок 1).

Рисунок 1 – раздел «Методы оплаты»

Рисунок 1 – раздел «Методы оплаты»

3.4 Нажать кнопку «Добавить» (Рисунок 2).

Рисунок 3 - раздел «Установленные приложения»

Рисунок 3 - раздел «Установленные приложения»

3.5 Настраиваем метод оплаты:

3.5.1. В качестве платежной системы выбрать Экспресс Платежи - EPOS для установки модуля оплаты через систему EPOS(Рисунок 3).

Рисунок 3 – платежные системы

Рисунок 3 – платежные системы

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

3.5.2.1 Установите флажок в поле «Работа с тестовым стендом».

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

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

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

Рисунок 4 – настройка новой платежной системы в тестовом режиме

Рисунок 4 – настройка новой платежной системы в тестовом режиме

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

3.5.3.1 Убрать флажок в поле «Работа в тестовом режиме».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.5.5.9 Включение опции «Отсылать уведомления плательщикам по SMS» позволяет отсылать уведомления об оплате на номер телефона указанный при формировании заказа.

3.5.5.10 Включение опции «Отсылать уведомления плательщикам по электронной почте» позволяет отсылать уведомления об оплате на адрес электронной почты указанный при формировании заказа.

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