Расширение для CRM Битрикс24

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

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


Описание
Для ознакомления ниже представлена экранная форма главного меню приложения Битрикс24 (см. рисунок 1).
Модули для CRM Битрикс24 для приема платежей

Рис. 1. Главное меню приложения для Битрикс24 сервиса «Экспресс Платежи»

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

Инструкция по установке
1. Войти в портал Битрикс24.
2. В левом меню перейти в раздел "Приложения".
3. В каталоге приложений найти приложение «Экспресс Платежи».
4. Установить приложение и настроить согласно инструкции по настройке приложения для Битрикс24.

С возможностями приложения и преимуществами его использования можно ознакомиться в статье «Описание приложения Битрикс24».

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

Скачать


Описание
Ниже на изображении представлен пример работы расширения в администраторской части CMS 1С-Битрикс
Модули для CMS 1С-Битрикс для приема платежей
Нажмите для увеличения

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

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

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

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

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

1.1 Войти в портал Битрикс24.

1.2 В левом меню перейти в раздел «Приложения».

1.3 В каталоге приложений в разделе «Платежные системы» найти приложение «Экспресс Платежи: ЕРИП».

1.4 Настройка приложения, для приема платежей в магазине

1.4.1 Перейти в раздел «Магазин» (Рисунок 1).

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

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

1.4.2 Перейти в раздел «Настройки» => «Платежные системы»(Рисунок 2)

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

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

1.4.3 Нажать кнопку «Добавить платежную систему» (Рисунок 3).

Рисунок 3 – кнопка «Добавить платежную систему»

Рисунок 3 – кнопка «Добавить платежную систему»

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

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

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

1.4.4.2. Заполните поля «Заголовок», «Название», «Сортировка» и «Описание». Значение из поля «Название» будет отображаться в списке платежных систем, а также при выборе метода оплаты в корзине. Значение из поле «Описание» будет отображаться при выборе метода оплаты в корзине. Поле «Сортировка» отвечает за порядок отображения платежных систем в корзине. Чем выше значение этого поля, тем ниже платежная система будет отображаться в корзине.

1.4.4.3 В поле «Логотип платёжной системы» нажмите кнопку «Добавить файл» и выберете файл, который будет отображаться в корзине для данной платежной системы

1.4.4.4 Поле «Открывать в новом окне» оставить пустым.

1.4.4.5 В поле «Тип оплаты» выбрать «Эквайринговая операция».

1.4.4.6 Поля «Разрешить автопересчет оплаты», «Разрешить печать чеков», «Кодировка», «Код» оставьте пустыми. Значение в поле «Внешний код» генерируется автоматически системой 1С-Битрикс (Рисунок 5).

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

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

1.4.4.7 В разделе «Настройка обработчика ПС» выберите вкладку «По умолчанию» (Рисунок 6).

Рисунок 6 – вкладка «По умолчанию» в разделе «Настройка обработчика ПС»

Рисунок 6 – вкладка «По умолчанию» в разделе «Настройка обработчика ПС»

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

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

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

1.4.4.8.1.1 Все настройки для настройки платежной системы в тестовом режиме заданы по умолчанию. Нажмите кнопку «Сохранить».

1.4.4.8.2 Настройка платежной системы, для работы:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.5 Настройка приложения, для приема платежей через счет в CRM

1.5.1 Перейти в раздел «CRM» (Рисунок 11).

Рисунок 11 – раздел «CRM»

Рисунок 11 – раздел «CRM»

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

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

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

1.5.3 Нажать кнопку «Создать платежную систему» (Рисунок 13).

Рисунок 13 – кнопка «Создать платежную систему»

Рисунок 13 – кнопка «Создать платежную систему»

1.5.4 Далее следовать пунктам 1.4.4.1-1.4.4.8.3.

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

2.1 Войти в портал Битрикс24.

2.2 В левом меню перейти в раздел «Приложения».

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

2.4 Настройка приложения, для приема платежей в магазине

2.4.1 Перейти в раздел «Магазин» (Рисунок 1).

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

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

2.4.2 Перейти в раздел «Настройки» => «Платежные системы»(Рисунок 2)

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

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

2.4.3 Нажать кнопку «Добавить платежную систему» (Рисунок 3).

Рисунок 3 – кнопка «Добавить платежную систему»

Рисунок 3 – кнопка «Добавить платежную систему»

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

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

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

2.4.4.2. Заполните поля «Заголовок», «Название», «Сортировка» и «Описание». Значение из поля «Название» будет отображаться в списке платежных систем, а также при выборе метода оплаты в корзине. Значение из поле «Описание» будет отображаться при выборе метода оплаты в корзине. Поле «Сортировка» отвечает за порядок отображения платежных систем в корзине. Чем выше значение этого поля, тем ниже платежная система будет отображаться в корзине.

2.4.4.3 В поле «Логотип платёжной системы» нажмите кнопку «Добавить файл» и выберете файл, который будет отображаться в корзине для данной платежной системы

2.4.4.4 Поле «Открывать в новом окне» оставить пустым.

2.4.4.5 В поле «Тип оплаты» выбрать «Эквайринговая операция».

2.4.4.6 Поля «Разрешить автопересчет оплаты», «Разрешить печать чеков», «Кодировка», «Код» оставьте пустыми. Значение в поле «Внешний код» генерируется автоматически системой 1С-Битрикс (Рисунок 5).

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

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

2.4.4.7 В разделе «Настройка обработчика ПС» выберите вкладку «По умолчанию» (Рисунок 6).

Рисунок 6 – вкладка «По умолчанию» в разделе «Настройка обработчика ПС»

Рисунок 6 – вкладка «По умолчанию» в разделе «Настройка обработчика ПС»

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

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

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

2.4.4.8.1.1 Все настройки для настройки платежной системы в тестовом режиме заданы по умолчанию. Нажмите кнопку «Сохранить».

2.4.4.8.2 Настройка платежной системы, для работы:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.5 Настройка приложения, для приема платежей через счет в CRM

2.5.1 Перейти в раздел «CRM» (Рисунок 11).

Рисунок 11 – раздел «CRM»

Рисунок 11 – раздел «CRM»

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

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

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

2.5.3 Нажать кнопку «Создать платежную систему» (Рисунок 13).

Рисунок 13 – кнопка «Создать платежную систему»

Рисунок 13 – кнопка «Создать платежную систему»

2.5.4 Далее следовать пунктам 2.4.4.1-2.4.4.8.3

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

3.1 Войти в портал Битрикс24.

3.2 В левом меню перейти в раздел «Приложения».

3.3 В каталоге приложений в разделе «Платежные системы» найти приложение «Экспресс Платежи: E-POS».

3.4 Настройка приложения, для приема платежей в магазине

3.4.1 Перейти в раздел «Магазин» (Рисунок 1).

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

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

3.4.2 Перейти в раздел «Настройки» => «Платежные системы»(Рисунок 2)

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

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

3.4.3 Нажать кнопку «Добавить платежную систему» (Рисунок 3).

Рисунок 3 – кнопка «Добавить платежную систему»

Рисунок 3 – кнопка «Добавить платежную систему»

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

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

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

3.4.4.2. Заполните поля «Заголовок», «Название», «Сортировка» и «Описание». Значение из поля «Название» будет отображаться в списке платежных систем, а также при выборе метода оплаты в корзине. Значение из поле «Описание» будет отображаться при выборе метода оплаты в корзине. Поле «Сортировка» отвечает за порядок отображения платежных систем в корзине. Чем выше значение этого поля, тем ниже платежная система будет отображаться в корзине.

3.4.4.3 В поле «Логотип платёжной системы» нажмите кнопку «Добавить файл» и выберете файл, который будет отображаться в корзине для данной платежной системы

3.4.4.4 Поле «Открывать в новом окне» оставить пустым.

3.4.4.5 В поле «Тип оплаты» выбрать «Эквайринговая операция».

3.4.4.6 Поля «Разрешить автопересчет оплаты», «Разрешить печать чеков», «Кодировка», «Код» оставьте пустыми. Значение в поле «Внешний код» генерируется автоматически системой 1С-Битрикс (Рисунок 5).

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

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

3.4.4.7 В разделе «Настройка обработчика ПС» выберите вкладку «По умолчанию» (Рисунок 6).

Рисунок 6 – вкладка «По умолчанию» в разделе «Настройка обработчика ПС»

Рисунок 6 – вкладка «По умолчанию» в разделе «Настройка обработчика ПС»

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

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

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

3.4.4.8.1.1 Все настройки для настройки платежной системы в тестовом режиме заданы по умолчанию. Нажмите кнопку «Сохранить».

3.4.4.8.2 Настройка платежной системы, для работы:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.5 Настройка приложения, для приема платежей через счет в CRM

3.5.1 Перейти в раздел «CRM» (Рисунок 11).

Рисунок 11 – раздел «CRM»

Рисунок 11 – раздел «CRM»

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

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

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

3.5.3 Нажать кнопку «Создать платежную систему» (Рисунок 13).

Рисунок 13 – кнопка «Создать платежную систему»

Рисунок 13 – кнопка «Создать платежную систему»

3.5.4 Далее следовать пунктам 3.4.4.1-3.4.4.8.3