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

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

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

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

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

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

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

2f12a561da510ea21c1b318ab5e82c4a.jpg

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

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

Интеграции 

  • /api/payment/create-invoice
  • /api/payment/create-invoice/api/payment/(updateInvoice|check)

Оплаты 

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

Справочники

  • /api/reference/sites

Добавление нового магазина в Robokassa

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

Для добавления нового магазина (сайта) обратитесь в техническую поддержку Robokassa с запросом: "Добавьте новый магазин с тем же URL для интеграции модуля Robokassa и retailCRM и снимите для него проверку на соотвествие урлов". В запросе на активацию укажите адрес своего сайта для подключения.

После добавления нового магазина перейдите в настройки, на вкладке "Технические настройки" заполните поля:

- url магазина (как и основной магазин);

- идентификатор магазина;

- создайте пароль #1 и пароль #2 (они потребуются для создания синхронизации в retailcrm.services);

- в поле "Result Url" нужно указать ссылку из уведомлений для Robokassa после создания синхронизации (см. раздел "Добавление webhook в магазине Robokassa"). Обязательно для заполнения ссылкой из retailcrm.services. Сейчас в поле "Result Url" нельзя добавить ссылку, несоотвествующую домену магазина. Для добавления исключения ссылок retailcrm.services обратитесь в техническую поддержку;

- методы отсылки для всех полей Get;

- в поле "Success Url" можно ввести ссылку из уведомлений для Robokassa после создания синхронизации (см. раздел "Добавление webhook в магазине Robokassa"). Необязательно для заполнения ссылкой из retailcrm.services;

- в поле "Fail Url" можно ввести ссылку из уведомлений для Robokassa после создания синхронизации (см. раздел "Добавление webhook в магазине Robokassa"). Необязательно для заполнения ссылкой из retailcrm.services;

Поля "Success Url" и "Fail Url" необязательно заполнять ссылками из retailcrm.services. Это могут быть любые ссылки на страницы, где будет написано либо про удачную, либо про неудачную оплату заказа. Важно, чтобы эти страницы открывались без ошибок при редиректе с Робокассы. По желанию в поле можно использовать ссылки из retailcrm.services.

Пример заполнения данных ниже:

-_________________________2020-03-08_18-27-15.jpg

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

  1. Перейдите в раздел создании настройки синхронизации "Robokassa" и нажмите кнопку "Создать новую синхронизацию"
  2. На странице создания синхронизации выберите аккаунт retailCRM, введите идентификатор созданного магазина в Robokassa, укажите пароль 1 и пароль 2.
5cd4299cce74a7f5b6f5c5dc1c3f9924.png
3a8afab2ff6ff03d4d58b6b7290d82ea.png

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

8e77e541521ca6af209b1711874a2735.png

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

Добавление webhook в магазине Robokassa

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

b462acb26bf85b5756219bd73fe9eef7.png

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

retailCRM.Services_________________retailCRM___Robokassa_2020-04-24_12-40-38.jpg

3. Перейдите в созданный магазин на вкладку "Технические настройки" и заполните поля "Result Url", "Success Url" и "Fail Url" соотвествующими ссылками. Поле "Result Url" является обязательным для заполнения, поля "Success Url" и "Fail Url" - необязательными.

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

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

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

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

Robokassa__________________________________________________retailCRM_2020-03-08_14-24-56.jpg

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

Robokassa__________________________________________________retailCRM_2020-03-08_14-26-21.jpg

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

______________________________________________________________retailCRM_2020-03-08_18-42-26.jpg

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

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

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

1. Добавить новый магазин согласно инструкции

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

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

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

e019ac32cdafc6e54aaf0de4bd5059c6.png

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

520019127691d38cd68be254a48a65a6.png

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

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

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

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

a09c4f3e5527f22a7c3c4d187aa17798.png

Ответы на частозадаваемые вопросы по работе с модулем Robokassa находятся в разделе Частозадаваемые вопросы. 

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