Общие сведения о Платежном сервисе

Платежный сервис Роутер – сервис маршрутизации платежных транзакций, предназначенный для динамического переключения оплат между банками. Платежный сервис Роутер одновременно подключается к платежным шлюзам (ПШ) нескольких банков, с которыми работает Партнер (мерчант), и при поступлении заказа направляет заказ в тот или иной банк на основании правил маршрутизации, которые разрабатываются индивидуально для Партнера.

API Платежного сервиса по большей части повторяет API платежного шлюза банка (основные отличия см. здесь). Если Партнер уже интегрирован с одним из банков-эквайеров, API Платежного сервиса будет для него понятным и знакомым.

Способы оплаты и маршрутизация

Способы оплаты

Платежный сервис поддерживает оплату банковскими картами, а также Vendor Pays — платежные методы банков и платежных систем.

Новая или сохраненная карта (связка)

СБП, в том числе Цифровой рубль

Яндекс Пэй и Яндекс Сплит (через Yandex Paybox)

Mir Pay

SberPay, Alfa Pay, T-Pay

Маршрутизация

Партнер задает правила маршрутизации платежей между своими банками исходя из оптимизации комиссии за те или иные транзакции.

Маршрутизация по всем доступным параметрам платежа

Балансировка платежей между банками в заданном процентном отношении

Оплата Vendor Pays в банки, где у Партнера подключены эти Vendor Pays

Устойчивость к отказам на стороне банков

Простая и расширенная интеграция

Платежная страница Платежного сервиса

Клиент выполняет оплату на платежной странице Платежного сервиса.

Платежная страница Платежного сервиса не привязана к банкам

Доступны все способы оплаты, которые Партнер подключил в своих банках

Кастомизация и брендирование по дизайну Партнера

Минимальное использование API

Собственная платежная страница Партнера

Партнер принимает оплату в своем мобильном или веб-приложении с помощью API Платежного сервиса.

API для интеграции без использования Платежной страницы Платежного сервиса

Mobile SDK Core для шифрования платежных данных

Web SDK Payment для безопасного сбора данных карты на странице Партнера

Требует программной разработки

Основные преимущества

Устойчивость к отказам на стороне банков

Платежный сервис обеспечивает устойчивость к отказам и непредвиденным ситуациям на стороне банка-эквайера

При сбоях у одного эквайера трафик автоматически переключается на другого

Исключите банк из маршрутизации на заданный интервал (например, на время работ)

Фиксируйте отдельные методы оплаты за конкретным банком (например, SberPay — только Сбербанк), без переадресации

Для настройки обратитесь в службу поддержки.

Конвертация валюты при оплате

Партнер может оформлять заказы в одной валюте, а платежи проводить в другой.

Платежный сервис конвертирует валюту заказа в целевую валюту выбранного банка

Исходная валюта заказа может быть скрыта и от целевого банка, и от клиента

Партнер может настроить дополнительную комиссию за конвертацию

Конвертация по курсу ЦБ РФ

Сохраненные платежные данные

Платежный сервис поддерживает сохранение платежных данных для последующей оплаты.

Оплата сохраненными картами на платежной странице

Рекуррентные списания

Платежи в рассрочку

Оплата связками Vendor Pays (SberPay, Яндекс Пэй, СБП, T-Pay и т.п.)

Операторы фискальных данных (ОФД)

Платежный сервис позволяет использовать фискализацию, которая подключена в банках Партнера.

Фискализация настраивается на стороне банка

Запрос данных чека через API Платежного сервиса

Подключение Партнера

Для подключения к Платежному сервису Партнер должен:

Заключить договор с каждым банком-эквайером.
Обратиться в службу сопровождения для регистрации в платежных шлюзах каждого банка (если Партнер там еще не зарегистрирован), а также для регистрации в Платежном сервисе.

В результате регистрации Партнер получает адрес API Платежного сервиса, а также логин и пароль для отправки API-запросов.

Ограничения Платежного сервиса

Списания бонусов Vendor Pays не поддерживаются.
Во всех банках у Партнера должны быть одинаковые учетные данные (логин и пароль) и настройки.

Маршрутизация оплат

Платежный сервис Роутер маршрутизирует оплату заказа в момент нажатия на кнопку оплаты на платежной странице или при вызове метода оплаты (например, paymentOrder.do, paymentOrderBinding.do, /alfapay/paymentOrder.do и др.). Маршрутизация осуществляется согласно правилам, заданным в Платежном сервисе. Чтобы задать правила, обратитесь в службу поддержки. Чтобы узнать текущие правила маршрутизации и другие настройки, выполните запрос /settings/getRouterParams.do.

В зависимости от способа оплаты поддерживаются следующие возможности маршрутизации:

Способ оплаты	Способы маршрутизации
Карта	По всем доступным параметрам платежа: сумма и параметры заказа (features, jsonParams), банк-эмитент карты, платежная система, тип карточного продукта (дебетовая или кредитная), принадлежность к определенному range и т.п. В процентном соотношении между заданными банками. Строго в банк, указанный Партнером в параметре `gwId` запроса register.do или registerPreAuth.do. Если этот банк недоступен, то выбор альтернативного не происходит и оплата завершается ошибкой. В резервный банк в случае, если выбранный по правилу недоступен. Если резервные банки не указаны, Платежный сервис может сам выбрать банк при наличии такой возможности.
Карточная связка	В целом аналогично картам, но могут быть особенности в зависимости от типа связки и настроек, см. Маршрутизация
СБП	Оплата может быть направлена только в те банки, с которыми у Партнера заключено соглашение о приеме платежей по СБП. Дополнительно поддерживается маршрутизация: По некоторым параметрам платежа (сумма, `features`, `jsonParams` и т.д.) В процентном соотношении между заданными банками В резервный банк (один из СБП-банков Партнера) в случае, если выбранный по правилу недоступен. При оплате с мобильного устройства доступна маршрутизация по банку Клиента.
Подписки СБП	В зависимости от способа оплаты подпиской, см. Оплата подпиской СБП
Vendor Pays	Оплата может быть направлена только в те банки, с которыми Партнер договорился о приеме данного Vendor Pay. Маршрутизация одного Vendor Pay в несколько банков возможна, только если данный способ оплаты поддерживается в нескольких банках (например, Mir Pay).
Связки Vendor Pays	Только в тот банк, где создана связка