Подключение модуля "CloudPayments"

Последние изменения: 26.08.2021

Модуль CloudPayments позволяет:

  • создать короткую ссылку на оплату заказа из RetailCRM;

  • отправлять ссылку на оплату в email, смс, мессенджеры;

  • автоматически изменить статус оплаты RetailCRM в случае успешной оплаты заказа (в ручном или автоматическом режиме;

  • подключить несколько магазинов из CloudPayments в 1 аккаунт RetailCRM.

Для подключения модуля "CloudPayments" необходимо подключить аккаунт RetailCRM в систему retailcrm.services, создать новый сайт в платежной системе, настроить синхронизацию в retailcrm.services и добавить нужные события в настройки сайта в CloudPayments. Вся настройка занимает не более 15 минут.

Последовательность действий описана ниже:

Проверка настроек API ключа

Перейдите в раздел Настройки → Интеграции → Ключи доступа API:

e3ac4787a176d93fcc4d19f3df383c13.png

Выберите ключ, который использовали для авторизации в retailcrm.services, и проверьте настройки:

  1. Тип доступа. Если загрузка данных будет осуществляться в несколько магазинов, то необходимо выбрать тип доступа "Для всех магазинов".

  2. В блоке "Разрешенные методы API" проставьте все галки для методов групп:

Справочники 

  • /api/reference/sites 

Интеграции  

  • /api/integration-modules/{code} 

  • /api/integration-modules/{code}/edit

Платежи

  • /api/payment/(updateInvoice|check)

Добавление сайта CloudPayments в retailcrm.services

       1. Перейдите в раздел "Мои аккаунты".

       2. В блоке "Мои аккаунты CloudPayments" нажмите кнопку "Новый аккаунт".

       3. В Cloudpayments необходимо создать новый сайт. Если у вас создан сайт, то не нужно использовать данные для интеграции уже от созданного сайта.

       3. Введите Public ID и пароль для API от аккаунта CloudPayments (раздел сайты в аккаунте Cloudpayments в настройках нужного сайта). В названии укажите произвольное название аккаунта.

b824c4c7afba505dabfbe31e92eb8a1e.png

     4. Нажмите кнопку "Сохранить". Если данные сайта указаны корректно, сайт будет успешно добавлен в retailcrm.services.

Настройка синхронизации в retailcrm.services

  1. Перейдите в раздел создании настройки синхронизации "CloudPayments" и нажмите кнопку "Создать новую синхронизацию":

    37f12ca79ab8fccb6066ac791cbb1f20.png
  2. На странице создания синхронизации выберите аккаунтCloudPayments и аккаунт RetailCRM и способ подтверждения платежа.

921952482685db4734bb7cf5a5280b9c.png


Ручное подтверждение платежа означает, что после оплаты заказа клиентом вам необходимо зайти в заказ и вручную подтвердить оплату заказа.

3. Использовать сокращение ссылок — при активной галке ссылки на оплату будут короткие.

b00823839bf160cf4025fc5f1264384f.png

4. Отправка смс со ссылкой на оплату через CloudPayments — после генерации ссылки на оплату в RetailCRM клиенту отправится сообщение через сервис CloudPayments.

7db7f769ec3565f7d49a243755395010.png

Важно! Если используется триггер для отправки смс с ссылкой на оплату клиенту, стандартная ссылка будет отправлена в двух сообщениях.  

Добавление webhook в аккаунте CloudPayments

1. Нажмите на кнопку "Уведомления Cloudpayments":

02d6c8982159b0a4bd7a63ed0bea6978.png

 2. В появившемся окне вы увидите список ссылок для настройки уведомлений:

61f7dd84bc350e1baff0fa9265ebf6e3.png

3. Добавьте новый сайт в CloudPayments. В настройках сайта CloudPayments необходимо активировать переключатель каждого из указанных выше уведомлений и добавить ссылку в соответствующее поле адрес. Поля "кодировка" и "http метод" остаются без изменений.

Screenshot_29.png

Важно! Чтобы уведомления о событиях поступали из CloudPayments в RetailCRM, необходимо добавить новый сайт и для нового сайта добавлять веб-хуки. Если вы будете добавлять веб-хуки для имеющегося сайта, который используются для интеграции с сайтом, то у вас перестанут работать уведомления для сайта.

Настройка интеграции CloudPayments в RetailCRM

На стороне RetailCRM необходимо добавить интеграцию модуля для способа оплаты Cloudpayments, настроить соответствие статусов оплаты и в настройках способов доставок разрешить оплату.

1. Переходим в настройки вашего аккаунта RetailCRM в раздел "Типы оплат".

2. Создаем новую оплату и выбираем в поле "Интегрировать с" интеграционный модуль.

3. Нажимаем кнопку настройки статусов счетов и в появившемся окне сопоставляем статусы оплаты счета CloudPayments (левая колонка) и статусы оплат в RetailCRM (правая колонка). При необходимости из этого окна можно добавить сразу новый статус оплаты в RetailCRM.

0ca0aac5e73c745bb79c67f540b33f88.png

4. Проверьте, чтобы у нужных способов доставки была активирована галка способа оплаты CloudPayments. Если галка не будет активна, то способ оплаты не будет доступен в заказе для данного способа доставки.

380338af2be0e6611a3fa525cbc8ce7b.png

При активации галки "Внешняя фискализация" при условии, что в маркетплейс подключен модуль Атол, данные будут отправляться в Атол. Опция необходима, чтобы модуль «Атол Онлайн» смог корректно засчитать аванс. Со стороны RetailCRM необходимо иметь информацию о фискализации аванса. Вы получаете аванс по заказу и проводите оплату через свою кассу, а остаток проводите через интеграционный модуль «Атол Онлайн».

Независимо от активности модуля "Атол" в CloudPayments всегда отсылается параметр receipt. В случае, если внутри  кабинета CloudPayments настроить фискализацию, то чеки будут автоматически формироваться на стороне CloudPayments.

Работа с несколькими магазинами CloudPayments

В retailcrm.services возможно добавление неограниченного количества аккаунтов CloudPayments для работы в RetailCRM.

Для корректной работы необходимо добавить аккаунт платежной системы в retailcrm.services и создать синхронизацию для каждого нового добавленного аккаунта. 

1. Для добавления аккаунта перейдите в "Мои аккаунты" и создайте аккаунт согласно инструкции

2. Для каждого сайта CloudPayments необходимо создать отдельную синхронизацию. Добавляйте новую синхронизацию согласно инструкции.   

3. Для каждой добавленной синхронизации нужно добавить отдельный тип оплаты для разнесения оплат по нужным сайтам CloudPayments. 

1. Переходим в настройки вашего аккаунта RetailCRM в раздел "Типы оплат". При добавлении нового аккаунта или синхронизации старый тип оплаты в RetailCRM нужно деактивировать и создать заново.

d056c0529ecc05034ba9279d25f41bdb.png

2. Создаем новую оплату и выбираем в поле "Интегрировать с" интеграционный модуль. Выберите нужную интеграцию из списка. Создавая новые типы оплаты в RetailCRM указывайте разные названия для удобной работы в заказе.

a4427919701040b6d52d837f972a0ff1.png



3. Нажимаем кнопку настройки статусов счетов и в появившемся окне сопоставляем статусы оплаты счета CloudPayments (левая колонка) и статусы оплат в RetailCRM (правая колонка). При необходимости из этого окна можно добавить сразу новый статус оплаты в RetailCRM.

4. Проверьте, чтобы у нужных способов доставки был активирована галка способа оплаты CloudPayments. Если галка не будет активна, то способ оплаты не будет доступен в заказе для данного способа доставки.

Важно! По умолчанию для интеграции Cloudpayments с RetailCRM используется двухстадийная оплата. Таким способом минимизируются возможные риски ошибок менеджеров, которые выставляют счета. Поэтому платежи нужно подтверждать вручную в ЛК CloudPayments. Для подтверждения оплаты автоматически в настройках сайта нужно указать количество дней, после которых платеж подтвердится автоматически.  

faf8d49ba852f42dfe3014a8e6da26c3.png

Поддержка Apple Pay в модуле CloudPayments

Apple Pay работает только в браузере Safari, браузер Google Chrome не поддерживается в связи с особенностями политики компании Apple. Поддержка Apple Pay уже реализована в модуле, дополнительных действий не требуется.
Страница оплаты в браузере Google Chrome выглядит так:
 

cfabbd5dd0a48c5a7bceb8745d3b01f1.png

Страница оплаты в браузере Safari выглядит так:

138316f36f7a9b7df3fceace2eb223cb.png

Важно: модуль не интегрирован с кассами, данные для формирования чеков передаются в эквайринг; чеки формируются на стороне эквайринга.

Перед началом работы

Ответы на частозадаваемые вопросы по работе с модулем Cloudpayments находятся в разделе Частозадаваемые вопросы. Ознакомьтесь со статьей Как работать с платежной системой CloudPayments в заказе RetailCRM. 

Помогла ли вам статья?