====== Платёжные шлюзы: ЮKassa и Best2Pay ======

ProPrepayer создаёт платёж в шлюзе ресторана и опрашивает шлюз об оплатах. Белый IP и входящие уведомления (вебхуки) не нужны.
Магазин или сектор регистрирует ресторан, деньги поступают напрямую ему. Гость видит в назначении платежа «Аванс, стол 15, заказ 15».

**Чек печатает r_keeper.** В шлюзе формирование и отправку чеков нужно **выключить**, иначе гость получит два чека на одну оплату.

Шлюз выбирается в админке, раздел «Платёжный шлюз». После ввода ключей нажмите «Сохранить» и «Проверить ключи».

===== ЮKassa =====
==== Что нужно от ресторана ====
  - Магазин в ЮKassa ([[https://yookassa.ru]]) с подключёнными способами оплаты (карты, СБП и др.).
  - В личном кабинете ЮKassa: Интеграция → Ключи API — **shopId** и **секретный ключ**.
  - В настройках магазина отправка чеков (54-ФЗ) через ЮKassa **выключена**.

==== Поля в админке ====
  * **shopId** — идентификатор магазина.
  * **Секретный ключ** — хранится в настройках в зашифрованном виде, в админке показывается точками.
  * **Страница после оплаты** — **обязательна**, этого требует ЮKassa. Обычно это сайт ресторана: туда гость попадёт после оплаты.

{{:external:proprepayer:proprepayer_admin_gw_yk.png?direct&900|ЮKassa}}

//1 — выбор шлюза; 2 — shopId и секретный ключ; 3 — страница после оплаты; 4 — «Проверить ключи».//

==== Особенности ====
  * Ссылка ЮKassa действует **1 час**. Это задаёт ЮKassa, изменить нельзя.
  * Отменить неоплаченную ссылку нельзя.
  * В предоплату вносится полная сумма оплаты, без вычета комиссии.
  * Возврат — в личном кабинете ЮKassa.

===== Best2Pay / Paygine =====

==== Что нужно от ресторана ====
  - Договор с Paygine (Best2Pay) и **сектор** для приёма оплат по ссылкам. Менеджер Paygine выдаёт номер сектора и **пароль подписи**.
  - Попросите менеджера Paygine **отключить фискализацию на секторе**: чек печатает r_keeper.
  - Уточните у менеджера алгоритм подписи (MD5 или SHA-256).

==== Поля в админке ====
  * **Адрес API** — боевой https://pay.best2pay.net, тестовый https://test.best2pay.net (подходят и pay.paygine.com / test.paygine.com).
  * **Сектор** — номер сектора.
  * **Пароль подписи** — хранится в зашифрованном виде.
  * **Алгоритм подписи** — MD5 или SHA-256. Если «Проверить ключи» отвечает «код 109», пароль неверный **или** выбран не тот алгоритм — переключите алгоритм и проверьте снова.
  * **Срок жизни ссылки** — от 5 минут до 72 часов, по умолчанию 60 минут. После этого срока оплатить по ссылке нельзя.
  * **Страница после оплаты** — необязательна. Если пусто, Best2Pay покажет гостю свой экран с результатом.

{{:external:proprepayer:proprepayer_admin_gw_b2p.png?direct&900|Best2Pay / Paygine}}

//1 — адрес API; 2 — сектор и пароль подписи; 3 — алгоритм подписи; 4 — срок жизни ссылки; 5 — страница после оплаты; 6 — «Проверить ключи».//

==== Особенности ====
  * На странице оплаты гость выбирает карту, СБП или Yandex Pay (в зависимости от настроек сектора).
  * Отменить неоплаченную ссылку и получить короткую ссылку нельзя.
  * Все запросы к Best2Pay и ответы на них пишутся в лог ProPrepayer (logs\proprepayer.log) на обычном уровне логирования — это поможет разобраться при первых внедрениях. Пароль в лог не пишется.
  * Возврат — в личном кабинете Best2Pay.


===== Смена шлюза =====
Меняйте шлюз, когда нет неоплаченных ссылок. После смены ProPrepayer проверяет оплаты только у нового шлюза: если гость оплатит старую ссылку, оплата не будет найдена автоматически.