ЮKassa Эквайринг для RetailCRM

1. Войдите под своей учетной записью в RetailCRM с правами администратора.

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

3. Нажмите кнопку «Добавить».

4. Выберите тип доступа к магазину.

5. Отметьте магазин из списка, с которым будет работать модуль.

6. Отметьте методы из списка Разрешенные методы API. (Нужные методы указаны в Приложении 1).

7. Скопируйте ключ, он понадобится в следующем пункте настроек.

8. Нажмите «Сохранить».

Не рекомендуется использовать уже существующий API-ключ. Для каждой интеграции создавайте новый API-ключ.

1. Перейдите в Настройки/Интеграции/Маркетплейс.

2. Выберите модуль.

3. Нажмите кнопку «Перейти в личный кабинет». При первом входе откроется страница регистрации.

Вкладка «Доступ RetailCRM»

1. Вводим ссылку на RetailCRM.

2. Вставляем скопированный ранее API-ключ.

3. В поле «Способ интеграции» выбираем ЮKassa.

4. Нажимаем «Сохранить».

Вкладка «Настройки ЮKassa»

Идентификатор магазина (shop_id) и Ключ API (secret_key) — логин и пароль от интеграционной записи Юкасса. Найти можно в настройках API интеграции в ЛК Юкассы.

Подтверждение оплаты в RetailCRM — Настройка, позволяющая использовать Холдирование.

Система налогообложения магазина — укажите систему налогообложения.

Ссылка для перенаправления после успешного платежа и после ошибки — укажите ссылки, по которым будет совершена автоматическая переадресация в случае успеха/ошибки при оплате.

Сокращать ссылку на платеж — формирует сокращённую(короткую) ссылку для оплаты.

Передача состава корзины — передаёт в чеке перечень товаров из заказа RetailCRM.

Подменять состав корзины — вместо товаров корзины принудительно передаёт к чек указанное наименование. Тип расчёта в этом случае будет всегда «Предоплата 100%». При активной подмене, она же действует и на закрывающий чек.

ВАЖНО! С помощью подменяемого товара можно передавать в чек отображаемый номер заказа Retail. Для этого добавьте переменную {orderNumber} в поле «Название товара».

URL для уведомлений (Обязательный для настройки в ЮKassa для всех событий) — указывается в соответствующем поле в настройках интеграции API в Юкассе. Без этого адреса Юкассе будет некуда присылать статусы оплаты.

Нажимаем «Сохранить».

Вкладка «Чеки закрытия»

URL триггера RetailCRM на изменение заказа, для отправить чека закрытия в ЮKassa — данный URL предназначен для встраивание в триггер(на изменения заказа/перехода в определенный статус).

Статусы непередаваемых в чеке товаров — товары в заказе в этих статусах не будут передаваться в чеках закрытия.

Тип расчета — тип расчёта для чеков закрытия.

Нажимаем «Сохранить».

Образец триггера для отправки чека закрытия

Вкладка «Чеки платежей с сайта»

Вкладка нужна, когда покупатель платит на сайте, а закрывающий чек надо пробить по кассе этого сайта, а не по кассе, указанной на вкладке «Настройки ЮKassa».

Соответствие типов платежей RetailCRM аккаунтам ЮКасса — укажите идентификатор магазина (shop_id) и ключ API (secret_key) той кассы, через которую прошла оплата, напротив соответствующего типа оплаты RetailCRM.

Как искать платёж для чека закрытия — определяет, откуда модуль возьмёт идентификатор платежа в ЮKassa. Без него касса не примет закрывающий чек.

• По идентификатору платежа из заказа (UUID) — вариант по умолчанию. Подходит, когда оплату на сайте принимает официальная интеграция RetailCRM: она кладёт идентификатор платежа ЮKassa в поле «Внешний ID» платежа заказа.
• По коду заказа и сумме — модуль сам находит платёж в кассе. Нужен, если сайт передаёт в «Внешний ID» собственный номер (так делает, например, insales) — тогда идентификатора ЮKassa в заказе нет вовсе.

Поиск по коду заказа и сумме намеренно строгий: совпасть должны и сумма до копейки, и номер либо внешний код заказа в описании платежа, а сам платёж быть в статусе «успешен». Если под условие подходит несколько платежей или ни одного, чек не отправляется, а причина пишется в журнал модуля — так закрывающий чек не привяжется к чужой оплате.

Чеки формируются в соответствии с настройками предыдущей вкладки, по тому же URL.

Нажимаем «Сохранить».

1. Перейдите в RetailCRM/Администрирование/Справочники/Типы оплат. Нажмите кнопку «Добавить».

2. Введите название типа оплаты (Пример: ЮKassa-Эквайринг).

3. Введите символьный код типа оплаты (Пример: yukassa-shop).

4. Выберите из списка «Интегрировать с» нужный магазин, с которым будет работать указанный аккаунт в модуле.

5. В поле «Статусы счетов» — нажмите на кнопку «Перейти к настройке». Соотнесите статусы платежей со статусами оплат из RetailCRM.

6. Нажмите «Сохранить».

Подсказка. Не забудьте разрешить новые способы оплаты в настройках типов доставки, иначе оплаты будут недоступны.

ДЛЯ ИНТЕГРАЦИОННЫХ ТИПОВ ОПЛАТЫ НЕЛЬЗЯ ВЫБИРАТЬ НАЛОЖЕННЫЙ ПЛАТЁЖ!

Необходимые методы API RetailCRM для работы модуля

ВАЖНО! Обязательно должно быть так же активно чтение списка товаров.

• Обратите внимание. Через систему RetailCRM возможен только полный возврат. Частичный не предусмотрен (только через личный кабинет ЮKassa). При этом подразумевается, что платежная система сама формирует и отправляет чек возврата.
• Нумерация заказов должна быть уникальна. В случае если ранее выставлялись счета через личный кабинет ЮKassa, и номер заказа уже такой существует, счет на заказ с таким же номером заказа создан не будет.
• Удаления выставленного счета возможно после отмены счета. При истечении времени ссылки счет также будет автоматически отменен. Если клиент выбрал иной способ оплаты, можно просто создать новый способ оплаты с нужной суммой.
• Если возврат сделать не через модуль, а через личный кабинет ЮKassa, статус на возврат не изменится.
• Модуль позволяет создавать любое количество счетов в каждом заказе.

Возможные ошибки при работе с модулем:

• Невозможно выставить счет — не сходится сумма чека и товаров. Такое возможно если в названии товаров встречается спецсимволы, например %. $,#, *. Такие символы запрещены в чеке.
• Чек закрытия не отправляется, в журнале «Invalid request parameter, payment_id». ЮKassa не нашла платёж, к которому привязывается чек. Проверьте вкладку «Чеки платежей с сайта»: указаны ли доступы кассы, через которую прошла оплата, и верно ли выбран способ поиска платежа.