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

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

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

  • создать короткую ссылку на оплату заказа из retailCRM;
  • отправлять ссылку на оплату в email, смс, мессенджеры;
  • автоматически изменить статус оплаты retailCRM в случае успешной оплаты заказа (в ручном или автоматическом режиме;
  • подключить несколько магазинов из CloudPayments в 1 аккаунт retailCRM.

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

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

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

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

ce0d229eb6be71258ff363a756b62bd3.jpg

Выберите ключ, который использовали для авторизации в 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 в настройках нужного сайта). В названии укажите произвольное название аккаунта.

Screenshot_23.png

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

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

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

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

921952482685db4734bb7cf5a5280b9c.png


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

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

16a709b11e2ca1fabd8e70b83e360de4.png

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

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

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

retailCRM.Services_________________retailCRM___CloudPayments_2020-04-17_12-20-56.jpg

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

61f7dd84bc350e1baff0fa9265ebf6e3.png

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

Screenshot_29.png

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

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

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

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

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

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

Screenshot_31.png

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

Screenshot_32.png

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

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

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

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

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

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

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

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

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

0afe93bd81d42aca71ac56f7e93f0df3.png

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

a4427919701040b6d52d837f972a0ff1.png



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

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

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

faf8d49ba852f42dfe3014a8e6da26c3.png

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

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

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