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

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

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


Описание
Нажмите для увеличения

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

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

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

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

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

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

1.2 Перейти в раздел «Контент» => «Интернет-магазины»(Рисунок 1).

Рисунок 1 – раздел «Интернет-магазины»

Рисунок 1 – раздел «Интернет-магазины»

1.3 Далее выбрать ваш магазин.

1.4 Перейти в раздел «Справочники» => «Платежные системы»(Рисунок 2).

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

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

1.5 ВАЖНО!!! Записываем последний код платёжной системы.

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

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

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

1.7 В поле название ввести «Экспресс Платежи: ЕРИП».

1.8 В поле описание ввести «Оплата с помощью сервиса Экспресс Платежи: ЕРИП».

1.9 Установить галочку в поле «Активность».

1.10 В поле «Обработчик» полностью вставляем текст файла handler_erip.php

1.11 Редактируем строчку class Shop_Payment_System_Handler20 extends Shop_Payment_System_Handler. Вместо 20 ставим число, следующее за максимальным кодом платёжной системы.

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

1.12.1 Для переменной $_currency_id; устанавливаем значение текущей валюты используемой в вашем интернет-магазине.

1.12.2 Для переменной $isTest; устанавливаем значение 1.

1.12.3 Для переменных $token; $serviceId; устанавливаем значение, которые доступны по следующей ссылке:https://express-pay.by/docs/api/v1#sandbox

1.12.4 Для переменных $isUseSignature; $secretWord; значения заполняются только в том случае, если был выбран API ключ с параметрами«Применять цифровую подпись» и «Секретное слово».

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

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

1.13.1 Для переменной $_currency_id; устанавливаем значение текущей валюты используемой в вашем интернет-магазине.

1.13.2 Для переменной $isTest; устанавливаем значение 0.

1.13.3 Для переменных $token; $serviceId; устанавливаем значение, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 4, Рисунок 5)

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

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

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

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

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

1.13.5 Значение http://[адрес_вашего_сайта]/shop/cart/ необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 6). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 7). Данная опция позволяет автоматически изменять статус заказа после оплаты.

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

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

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

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

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

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

1.13.7 Значение из переменной $eripPath будет отображаться клиенту после формирования заказа и выставления счета в системе «Расчет» (Рисунок 8).

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

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

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

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

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

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

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

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

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

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

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

2.2 Перейти в раздел «Контент» => «Интернет-магазины»(Рисунок 1).

Рисунок 1 – раздел «Интернет-магазины»

Рисунок 1 – раздел «Интернет-магазины»

2.3 Далее выбрать ваш магазин.

2.4 Перейти в раздел «Справочники» => «Платежные системы»(Рисунок 2).

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

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

2.5 ВАЖНО!!! Записываем последний код платёжной системы.

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

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

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

2.7 В поле название ввести «Экспресс Платежи: Интернет-эквайринг».

2.8 В поле описание ввести «Оплата с помощью сервиса Экспресс Платежи: Интернет-эквайринг».

2.9 Установить галочку в поле «Активность».

2.10 В поле «Обработчик» полностью вставляем текст файла handler_card.php

2.11 Редактируем строчку class Shop_Payment_System_Handler20 extends Shop_Payment_System_Handler. Вместо 20 ставим число, следующее за максимальным кодом платёжной системы.

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

2.12.1 Для переменной $_currency_id; устанавливаем значение текущей валюты используемой в вашем интернет-магазине.

2.12.2 Для переменной $isTest; устанавливаем значение 1.

2.12.3 Для переменных $token; $serviceId; устанавливаем значение, которые доступны по следующей ссылке:https://express-pay.by/docs/api/v1#sandbox

2.12.4 Для переменных $isUseSignature; $secretWord; значения заполняются только в том случае, если был выбран API ключ с параметрами«Применять цифровую подпись» и «Секретное слово».

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

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

2.13.1 Для переменной $_currency_id; устанавливаем значение текущей валюты используемой в вашем интернет-магазине.

2.13.2 Для переменной $isTest; устанавливаем значение 0.

2.13.3 Для переменных $token; $serviceId; устанавливаем значение, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 4, Рисунок 5)

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

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

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

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

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

2.13.5 Значение http://[адрес_вашего_сайта]/shop/cart/ необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 6). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 7). Данная опция позволяет автоматически изменять статус заказа после оплаты.

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

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

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

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

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

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

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

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

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

3.2 Перейти в раздел «Контент» => «Интернет-магазины»(Рисунок 1).

Рисунок 1 – раздел «Интернет-магазины»

Рисунок 1 – раздел «Интернет-магазины»

3.3 Далее выбрать ваш магазин.

3.4 Перейти в раздел «Справочники» => «Платежные системы»(Рисунок 2).

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

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

3.5 ВАЖНО!!! Записываем последний код платёжной системы.

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

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

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

3.7 В поле название ввести «Экспресс Платежи: E-POS».

3.8 В поле описание ввести «Оплата с помощью сервиса Экспресс Платежи: E-POS».

3.9 Установить галочку в поле «Активность».

3.10 В поле «Обработчик» полностью вставляем текст файла handler_erip.php

3.11 Редактируем строчку class Shop_Payment_System_Handler20 extends Shop_Payment_System_Handler. Вместо 20 ставим число, следующее за максимальным кодом платёжной системы.

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

3.12.1 Для переменной $_currency_id; устанавливаем значение текущей валюты используемой в вашем интернет-магазине.

3.12.2 Для переменной $isTest; устанавливаем значение 1.

3.12.3 Для переменных $token; $serviceId; устанавливаем значение, которые доступны по следующей ссылке:https://express-pay.by/docs/api/v1#sandbox

3.12.4 Для переменных $isUseSignature; $secretWord; значения заполняются только в том случае, если был выбран API ключ с параметрами«Применять цифровую подпись» и «Секретное слово».

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

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

3.13.1 Для переменной $_currency_id; устанавливаем значение текущей валюты используемой в вашем интернет-магазине.

3.13.2 Для переменной $isTest; устанавливаем значение 0.

3.13.3 Для переменных $token; $serviceId; устанавливаем значение, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 4, Рисунок 5)

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

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

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

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

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

3.13.5 Значение http://[адрес_вашего_сайта]/shop/cart/ необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 6). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 7). Данная опция позволяет автоматически изменять статус заказа после оплаты.

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

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

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

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

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

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

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

3.13.9 Включение опции «Разрешено изменять адрес плательщика» позволяет плательщику изменять адрес при оплате заказа в дереве E-POS.

3.13.10 Включение опции «Разрешено изменять сумму оплаты» позволяет плательщику изменять сумму при оплате заказа в дереве E-POS.

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