Инструкция по настройки модуля

1. Создание Ключа доступа к API

• Шаг 1.1. Войдите под своей учетной записью в retailCRM
• Шаг 1.2. Перейдите в Настройки/Интеграции/Ключи доступа к API
• Шаг 1.3. Нажмите кнопку Добавить
• Шаг 1.4. Скопируйте содержимое из поля Ключ. Это Ключ доступа к API, с которым будет работать модуль
• Шаг 1.5. Отметьте магазины из списка, с которыми будет работать модуль
• Шаг 1.6. Отметьте методы из списка Разрешнные методы API. Нужные методы указаны в Приложении 1
• Шаг 1.7. Нажмите сохарнить

2. Вход в модуль

• Шаг 2.1. Перейдите в Настройки/Интеграции/Макретплейс
• Шаг 2.2. Выберите модуль PayKeeper Acquiring Module
• Шаг 2.3. Нажмите кнопку Перейти в личный кабинет

3. Настройка модуля

• Настройки retailCRM
  • Шаг 3.1. В поле Ключ доступа к API введите Ключ из шага 1.4
  • Шаг 3.2. В поле Ссылка на RetailCRM введите адрес вашей копии RetailCRM
  • Шаг 3.3. Нажмите кнопку Обновить. При успешной проверке и подключении к вашей RetailCRM появится окно с текстом Сохранено. Появится следующий блок Магазины
• Настройка Блока магазинов
  • Шаг 3.4. Выберите из списка один или несколько магазинов, с которыми должен работать модуль
  • Шаг 3.5. Нажмите Сохранить. При успешной проверке появится окно с текстом Сохранено. Появится следующий блок «Настройка PayKeeper»
• Настройки PayKeeper
  • Шаг 3.6. В поля: Ссылка на PayKeeper, Логин и Пароль введите соответствующие данные. Ссылка на PayKeeper должна быть вида: https://mysite.server.paykeeper.ru/ Поле «Секретное слово» описано дальше.
  • Нажмите кнопку Сохранить. При успешной проверке появится окно с текстом Сохранено.
  • Ссылка на 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.
• Секретное слово можете придумать или сгенерировать, главное чтоб совпадало с указанным в модуле.

4. Создание типов оплат

• Шаг 4.1. Перейдите в RetailCRM/Администрирование/Справочники/Типы оплат. Нажмите кнопку «Добавить».
• Шаг 4.2. Введите название типа оплаты. (Пример: Оплата PayKeeper. Магазин №1)
• Шаг 4.3. Введите символьный код типа оплаты (Пример: PayKeeper-acquiring-module)
• Шаг 4.4. Выберите из списка «Интегрировать с» нужный магазин, с которым будет работать модуль.
• Шаг 4.4. В поле «Статусы счетов» — нажмите на кнопку «Перейти к настройке». Соотнесите статусы платежей со статусами оплат из RetailCRM. Нажмите Сохранить

Подсказка.

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

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

 Возможные вопросы.

• • Количество возвратов лимитируется в настройках личного кабинета PayKeeper, раздел:

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

  • Из RetailCRM можно произвести возврат только на полную сумму платежа.
  • Если сделать возврат напрямую в личном кабинете PayKeeper, данный возврат не передастся в RetailCRM.
  • PayKeeper создает счет в личном кабинете только после того как был совершен переход по ссылке. Если перейти по ссылке несколько раз, то в личном кабинете будет несколько счетов. По этой особенности нет отмены счетов. Счет отменяется автоматически после окончания времени действия ссылки. После отмены счета — ссылка в CRM пропадает.
  • Выставленный счет нельзя отредактировать или удалить. Но можно в RetailCRM создать новый счет и вручную указать необходимую сумму для оплаты. После окончания времени ссылки, предыдущие счета отменяться автоматически каждую полночь.
  • Если в RetailCRM необходима работа модуля на несколько магазинов, необходимо для каждого магазина добавить для каждого магазина свой способ оплаты. Модуль при этом будет один.

Приложение №1

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

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