Модуль оплаты Drupal Commerce

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

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


Описание
Ниже на изображении представлен пример работы расширения в администраторской части CMS Drupal DrupalCommerce 7.x.
Модули для CMS Drupal для приема платежей
Нажмите для увеличения

Инструкция по установке
1. Войти в панель администрирования сайта, выбрать в меню пункт "Модули (Modules)->Добавить новый (Add New)".
2. На странице выбрать пункт "Загрузить (Upload Plugin)"
3. Выбрать архив DrupalCommerce_7.x_v.2.5.zip и нажать "Установить (Install Now)".
4. После установки перейти на страницу со списком установленных модулей.
5. Найти модуль «Экспресс Платежи: ЕРИП», включить его и затем нажать кнопку "Сохранить конфигурацию (Save Configuration)".
6. Dыбрать в меню пункт "Магазин (Store)->Конфигурация (Config)->Способы оплаты (Payment Methods)".
7. Нажать на ссылку "Изменить (Edit)".
8. В блоке "Действия (Actions)" нажать на ссылку "Изменить (Edit)" напротив способа оплаты «Экспресс Платежи: ЕРИП».
9. Заполняем поля настроек и сохраняем изменения.

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


Описание
Ниже на изображении представлен пример работы расширения в администраторской части CMS Drupal DrupalUbercat 4.x.
Модули для CMS DrupalUbercart для приема платежей
Нажмите для увеличения

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

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

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

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

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

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

1.2 Перейти в раздел «Расширения» (Рисунок 1).

Рисунок 1 – раздел «Расширения»

Рисунок 1 – раздел «Расширения»

1.3 Нажать кнопку «Установить новый модуль» (Рисунок 2).

Рисунок 2 – кнопка «Установить новый модуль»

Рисунок 2 – кнопка «Установить новый модуль»

1.4 Выбрать необходимый модуль (Рисунок 3).

Рисунок 3 – «Окно выбора модуля»

Рисунок 3 – «Окно выбора модуля»

1.5 Нажать кнопку «Установить».

1.6 Найти модуль в списке отметить его и нажать кнопку «Установить».

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

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

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

1.8 В качестве типа выбрать «Экспресс Платежи: Интернет-эквайринг» для установки модуля оплаты через систему интернет-эквайринга, и нажать кнопку «Добавить способ оплаты»(Рисунок 5).

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

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

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

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

1.9.1.1 Отметить галочкой пункт «Тестовый режим».

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

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

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

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

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

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

1.9.2.1 Убрать галочку из пункта «Тестовый режим».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.2 Перейти в раздел «Расширения» (Рисунок 1).

Рисунок 1 – раздел «Расширения»

Рисунок 1 – раздел «Расширения»

2.3 Нажать кнопку «Установить новый модуль» (Рисунок 2).

Рисунок 2 – кнопка «Установить новый модуль»

Рисунок 2 – кнопка «Установить новый модуль»

2.4 Выбрать необходимый модуль (Рисунок 3).

Рисунок 3 – «Окно выбора модуля»

Рисунок 3 – «Окно выбора модуля»

2.5 Нажать кнопку «Установить».

2.6 Найти модуль в списке отметить его и нажать кнопку «Установить».

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

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

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

2.8 В качестве типа выбрать «Экспресс Платежи: Интернет-эквайринг» для установки модуля оплаты через систему интернет-эквайринга, и нажать кнопку «Добавить способ оплаты»(Рисунок 5).

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

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

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

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

2.9.1.1 Отметить галочкой пункт «Тестовый режим».

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

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

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

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

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

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

2.9.2.1 Убрать галочку из пункта «Тестовый режим».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.2 Перейти в раздел «Расширения» (Рисунок 1).

Рисунок 1 – раздел «Расширения»

Рисунок 1 – раздел «Расширения»

3.3 Нажать кнопку «Установить новый модуль» (Рисунок 2).

Рисунок 2 – кнопка «Установить новый модуль»

Рисунок 2 – кнопка «Установить новый модуль»

3.4 Выбрать необходимый модуль (Рисунок 3).

Рисунок 3 – «Окно выбора модуля»

Рисунок 3 – «Окно выбора модуля»

3.5 Нажать кнопку «Установить».

3.6 Найти модуль в списке отметить его и нажать кнопку «Установить».

3.7 Перейти в раздел «Магазин» => «Методы оплаты»(Рисунок 4)

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

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

3.8 В качестве типа выбрать «Экспресс Платежи: E-POS» для установки модуля оплаты через систему E-POS, и нажать кнопку «Добавить способ оплаты»(Рисунок 5).

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

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

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

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

3.9.1.1 Отметить галочкой пункт «Тестовый режим».

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

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

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

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

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

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

3.9.2.1 Убрать галочку из пункта «Тестовый режим».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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