Интеграция PayKeeper с RetailCRM

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

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

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

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

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

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

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

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

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

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

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

3. Нажмите кнопку Перейти в личный кабинет.

Настройки RetailCRM

1. В поле Ключ доступа к API введите Ключ из шага 1.4.

2. В поле Ссылка на RetailCRM введите адрес вашей копии RetailCRM.

3. Нажмите кнопку Обновить. При успешной проверке и подключении к вашей RetailCRM появится окно с текстом Сохранено. Появится следующий блок Магазины.

Настройка Блока магазинов

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

5. Нажмите Сохранить. При успешной проверке появится окно с текстом Сохранено. Появится следующий блок «Настройка PayKeeper».

Настройки PayKeeper

6. В поля Ссылка на PayKeeper, Логин и Пароль введите соответствующие данные. Ссылка на PayKeeper должна быть вида: https://mysite.server.paykeeper.ru/ Поле «Секретное слово» описано дальше.

7. Нажмите кнопку Сохранить. При успешной проверке появится окно с текстом Сохранено.

Ссылка на Paykeeper — Ссылка на ваш ЛК Paykeeper, найти можно в стройке браузера.

Логин Paykeeper — Логин для входа в ЛК.

Пароль от Paykeeper — Пароль для входа в ЛК.

Секретное слово — слово указывается в ЛК Paykeeper в меню «Получение информации о платежах».

НДС доставки — фиксированная ставка НДС для передаваемой доставки, либо можно забирать значение из юр.лица Retail.

Время жизни ссылки — число дней, в течении которого, клиент может оплатить счет по ссылке.

E-mail по умолчанию — Email, передаваемый в платежах, если не указан email в заказе.

Текст для аванса — Редактируемое поле передаваемого текста для чеков аванса. Можно указывать любые значение из заказа Retail.
Например: «Оплата заказа {{order.id}}, {{order.number}}, {{order.date}}». Переменные можно легко найти в RetailCRM в шаблонах СМС. Все переменные из заказа указываются в двойных фигурных скобках.

Передавать аванс, как услугу — Передаёт товары в платеже с признаком Аванс, как услугу, а не как товар.

Добавлять артикул к названию товара — В платеже передаёт так же артикул товара из каталога.

Оплата QR кодом СБП — Позволяет оплатить так же СБП QR.

Отменяемые в RetailCRM платежи (После отмены, ссылки остаются рабочими) — Позволяет запретить отмену платежа. Может быть полезно, если нужно ограничить случайную отмену менеджерами.

Настройки на стороне PayKeeper

Смена статуса оплаты в RetailCRM будет происходить раз в 10 минут. Если необходимо чтоб статус оплаты изменялся сразу, необходимо произвести следующие настройки. Обратите внимание, чтоб в личном кабинете можно указать только одни адрес для уведомления.

Зайдите в личный кабинет PayKeeper. Перейдите в Настройки — Способ получения уведомления о платежах и выборе «Способ получения уведомления о платежах: POST» и укажите ссылку, полученную в модуле PayKeeper-RetailCRM.

Секретное слово можете придумать или сгенерировать, главное чтоб совпадало с указанным в модуле.

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

2. Введите название типа оплаты. (Пример: Оплата PayKeeper. Магазин №1).

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

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

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

Подсказка. Не забудьте разрешить новые способы оплаты в настройках типов доставки, иначе оплаты будут недоступны.
ДЛЯ ИНТЕГРАЦИОННЫХ ТИПОВ ОПЛАТЫ НЕЛЬЗЯ ВЫБИРАТЬ НАЛОЖЕННЫЙ ПЛАТЁЖ!

Количество возвратов лимитируется в настройках личного кабинета PayKeeper, раздел Доступ к панели администратора. При достижении лимита, модуль выдаст сообщение: достигнул лимит возвратов.

Из RetailCRM можно произвести возврат только на полную сумму платежа.

Если сделать возврат напрямую в личном кабинете PayKeeper, данный возврат не передастся в RetailCRM.

PayKeeper создает счет в личном кабинете только после того как был совершен переход по ссылке. Если перейти по ссылке несколько раз, то в личном кабинете будет несколько счетов. По этой особенности нет отмены счетов. Счет отменяется автоматически после окончания времени действия ссылки. После отмены счета — ссылка в CRM пропадает.

Выставленный счет нельзя отредактировать или удалить. Но можно в RetailCRM создать новый счет и вручную указать необходимую сумму для оплаты. После окончания времени ссылки, предыдущие счета отменяться автоматически каждую полночь.

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

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

Наш модуль поддерживает работу с несколькими магазинами сразу, для этого достаточно нажать на вкладке «Доступ» — Добавить экземпляр и настроить ещё раз по инструкции.