Skip to main content

Обзор

Redirect-интеграция позволяет перенаправить клиента на hosted-страницу оплаты Meridian. Клиент увидит реквизиты, таймер обратного отсчёта и кнопку для открытия банковского приложения (deeplink). После завершения платежа клиент автоматически перенаправляется обратно на ваш сайт.
Поддерживаемые банки: Сбербанк, ВТБ, Т-Банк, Газпромбанк, Солидарность, Альфа-Банк — у основного провайдера (коды 16) и у провайдера BankApi (коды 712). Плюс код 13 — СБП QR у провайдера BankApi.
Коды 16 и 712 — это одни и те же шесть банков у двух разных провайдеров (см. Коды банков). Deeplink поддерживается только у основного провайдера: для кодов 712 hosted-страница показывает реквизиты карты и инструкцию по переводу, кнопка открытия банковского приложения не отображается. Код 13 (СБП QR) deeplink не поддерживает по своей природе: банк отправителя заранее не известен — плательщик открывает приложение любого своего банка и сканирует QR-код. Hosted-страница показывает сам QR-код (на десктопе) или кнопку «Открыть в приложении банка» (на телефоне).
Коды 713 доступны только после подключения провайдера BankApi к вашему аккаунту; запрос с этими кодами без подключения вернёт 400. Для кодов 712 поддерживается только выдача карты (TO_CARD): paymentMethod: "TO_PHONE" вернёт 400. Код 13 не поддерживает paymentMethod вовсе — оба значения вернут 400.
Код 13: сумма в ответе может отличаться от запрошенной. Банк-получатель выставляет счёт на скорректированную сумму (например, 10001050), чтобы разделять платежи на один общий QR-реквизит. Определяющей является сумма из поля amount ответа — она же приходит во всех вебхуках, и по ней вы будете рассчитаны.На hosted-странице плательщику показывается диалог с изменённой суммой: он либо подтверждает и видит QR-код, либо отказывается — тогда он возвращается на ваш cancelUrl, а платёж не отменяется, а истекает по таймеру обычным порядком. Подробнее: Код 13 — СБП QR.

Создание платежа

Обязательные параметры


Пример запроса


Пример ответа (успех)

HTTP Status: 201 Created
Важно: Поле paymentUrl — это ссылка для перенаправления клиента. Токен в URL является единственным способом авторизации на странице оплаты. Не передавайте его третьим лицам.

Поля ответа


Структура dealRequisites

Поле dealRequisites содержит JSON-строку с реквизитами, куда клиент должен отправить платёж.
Важно: Поле bankName в ответе — это запрошенный банк. Фактический банк назначения находится в dealRequisites.bankName.

Проверка статуса

Используется тот же endpoint, что и для H2H интеграции.

Пример запроса


Webhook-уведомления

Webhook-уведомления работают идентично H2H интеграции. При изменении статуса платежа система отправляет POST-запрос на указанный notificationUrl.

Формат и верификация

См. полную документацию в разделе Трансграничные платежи — Webhook.

Создание апелляции

Если клиент оплатил, но статус не изменился, создайте апелляцию. Процесс идентичен H2H интеграции.