Платёжный шлюз сообщает Subrail об оплатах, отменах и возвратах уведомлениями. Без них Subrail узнаёт о платежах с опозданием, а часть событий не получит совсем: у Т-Банка это ссылка на чек. Настройте уведомления для каждого подключения: отдельно для тестового и рабочего магазина.
Где взять адрес уведомлений
Откройте «Настройки проекта → Оплата покупателей», в списке «Платёжные шлюзы» нажмите «Подключить» или «Настроить» у нужного шлюза и выберите магазин «Тестовый» или «Рабочий». После сохранения ключей в форме появится поле «Адрес уведомлений банка» или «Адрес уведомлений ЮKassa». У Robokassa это Result URL в мастере подключения.
Правила для всех шлюзов:
- копируйте адрес из Subrail целиком, ничего не дописывайте и не сокращайте;
- у тестового и рабочего магазина адреса разные: тестовый адрес — в тестовый магазин, рабочий — в рабочий. Исключение — Robokassa: у неё один Result URL на проект;
- адрес сайта, адрес лендинга и адрес другого проекта не подойдут;
- после замены ключей или подключения другого магазина откройте форму снова и сверьте адрес.
Т-Банк
- В личном кабинете интернет-эквайринга Т-Банка откройте «Магазины» и выберите магазин.
- На вкладке «Терминалы» нажмите «Настроить» у тестового терминала.
- В блоке уведомлений выберите получение по HTTP(S). Вариант «Почта» Subrail не подходит. Если нужен и email, выберите оба варианта.
- Вставьте адрес уведомлений тестового подключения из Subrail и сохраните.
- Повторите для рабочего терминала с адресом рабочего подключения.
Об оплатах Т-Банк сообщает по адресу, который Subrail передаёт в каждом платеже. Уведомления о фискализации и привязке карты он отправляет только на адрес из настроек терминала: без него покупатель не увидит ссылку на чек. Сами уведомления о фискализации включает поддержка Т-Банка — попросите её об этом.
Проверочная оплата из Subrail передаёт адрес сама, поэтому её успех не подтверждает настройку терминала. Сверьте адрес в настройках терминала отдельно.
ЮKassa
В каждом магазине ЮKassa откройте «Интеграция → HTTP-уведомления», нажмите «Изменить настройки», вставьте адрес уведомлений ЮKassa из Subrail и включите четыре события:
payment.succeeded— успешная оплата;payment.waiting_for_capture— ожидание подтверждения;payment.canceled— отмена или неуспешный платёж;refund.succeeded— успешный возврат.
Нажмите «Сохранить». Сначала настройте тестовый магазин, затем рабочий. Подробнее с изображениями — в шаге «Настройте уведомления о платежах» инструкции по ЮKassa. Для магазина самозанятого порядок тот же.
Альфа-Банк
Альфа-Банк включает уведомления (callback) на своей стороне, в личном кабинете их не настроить. Subrail передаёт адрес уведомлений в каждом заказе — это динамический callback. Банк отправит его, только если динамический callback включён для вашего API-логина.
Напишите вашему менеджеру или в поддержку интернет-эквайринга Альфа-Банка (acquiring@alfabank.ru) с просьбой включить callback-уведомления. Укажите:
- ИНН и API-логин — отдельно для тестового и рабочего магазина;
- тип callback-уведомлений — динамический;
- виды операций — успешное списание, отмена, возврат;
- адрес уведомлений из Subrail для этого логина — на случай, если банк попросит постоянный адрес.
Пароль API в письмо не включайте.
Robokassa
В технических настройках магазина Robokassa укажите Result URL из мастера Subrail, метод отсылки данных — POST, алгоритм расчёта хеша — SHA256. Result URL один на проект: он общий для тестового и рабочего режима. Подробнее — в шаге «Заполните технические настройки магазина» инструкции по Robokassa.
Robokassa присылает уведомление только об успешной оплате. Об отказе она не сообщает.
Проверьте, что уведомления приходят
Проведите проверочную оплату на 1 ₽ из формы шлюза и откройте историю тестовых платежей. После оплаты статус должен смениться на «Оплата подтверждена». Если он долго остаётся «Проверяем оплату»:
- сверьте адрес в кабинете шлюза с адресом в Subrail символ в символ;
- проверьте, что адрес вставлен в тот же магазин (тестовый или рабочий), ключи которого сохранены в Subrail;
- у ЮKassa проверьте, что включены все четыре события, у Robokassa — что выбран метод POST;
- у Альфа-Банка уточните у банка, включён ли динамический callback для логина.
Если всё совпадает, а статус не меняется, напишите в поддержку Subrail: название проекта, шлюз, время оплаты и номер операции. Ключи и пароли не присылайте.
Чек-лист
Личные отметки сохраняются только в этом браузере и не проверяют настройки проекта.