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

Приложение для CRM Insales для интеграции с сервисом «Экспресс Платежи» через API. Приложение позволяет выставить счет в системе «Расчет» (ЕРИП), E-POS, банковскими платежными картами, получить и обработать уведомление о платеже.

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


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

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

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

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

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

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

1.1 Войти в бэк-офис вашего магазина.

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

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

Рисунок 1 - раздел «Приложения»

1.3 Перейти в «Центр приложений»(Рисунок 2).

Рисунок 2 - раздел «Центр приложений»

Рисунок 2 - раздел «Центр приложений»

1.4 В каталоге приложений найти и установить приложение «Экспресс Платежи: ЕРИП».

1.5 Настраиваем платежную приложение:

1.5.1 В бэк-офисе магазина перейти "Приложения"(Рисунок 1) => "Установленные"(Рисунок 3).

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

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

1.5.2 Перейти в бэк-офис приложения нажав на его название (Рисунок 4).

Рисунок 4 - вход в бэк офис приложения

Рисунок 4 - вход в бэк офис приложения

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

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

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

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

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

Рисунок 5 – настройка приложения, для работы в тестовом режиме

Рисунок 5 – настройка приложения, для работы в тестовом режиме

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.1 Войти в бэк-офис вашего магазина

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

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

Рисунок 1 - раздел «Приложения»

2.3 Перейти в «Центр приложений»(Рисунок 2).

Рисунок 2 - раздел «Центр приложений»

Рисунок 2 - раздел «Центр приложений»

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

2.5 Настраиваем платежную систему:

2.5.1 В бэк-офисе магазина перейти "Приложения"(Рисунок 1) => "Установленные"(Рисунок 3)

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

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

2.5.2 Перейти в бэк-офис приложения нажав на его название (Рисунок 4)

Рисунок 4 - вход в бэк офис приложения

Рисунок 4 - вход в бэк офис приложения

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

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

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

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

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

Рисунок 5 – настройка приложения, для работы в тестовом режиме

Рисунок 5 – настройка приложения, для работы в тестовом режиме

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.1 Войти в бэк-офис вашего магазина.

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

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

Рисунок 1 - раздел «Приложения»

1.3 Перейти в «Центр приложений»(Рисунок 2).

Рисунок 2 - раздел «Центр приложений»

Рисунок 2 - раздел «Центр приложений»

3.4 В каталоге приложений найти и установить приложение «Экспресс Платежи: ЕРИП».

3.5 Настраиваем платежную приложение:

3.5.1 В бэк-офисе магазина перейти "Приложения"(Рисунок 1) => "Установленные"(Рисунок 3).

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

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

3.5.2 Перейти в бэк-офис приложения нажав на его название (Рисунок 4).

Рисунок 4 - вход в бэк офис приложения

Рисунок 4 - вход в бэк офис приложения

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

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

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

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

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

Рисунок 5 – настройка приложения, для работы в тестовом режиме

Рисунок 5 – настройка приложения, для работы в тестовом режиме

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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