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

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

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

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

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

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

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

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

1. Договор с Paygine (Best2Pay) и сектор для приёма оплат по ссылкам. Менеджер Paygine выдаёт номер сектора и пароль подписи.
2. Попросите менеджера Paygine отключить фискализацию на секторе: чек печатает r_keeper.
3. Уточните у менеджера алгоритм подписи (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 покажет гостю свой экран с результатом.

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

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

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