Общая информация и возможности
С помощью этого API можно принимать платежи:
- банковскими картами VISA, MasterCard и «Мир», выпущенных банками РФ,
- через SberPay,
- через СБП (доступно после открытия счета в Банке 131).
Платежная сессия
В рамках платежной сессии session
проходят все операции в API. Одна платежная сессия может объединять несколько
операций, например, платеж и возврат.
Вы можете принимать платежи двумя способами:
- с одновременным стартом сессии и платежа (одним запросом
session/init/payment); - сначала создать сессию, а потом инициировать платеж (двумя запросами:
session/createиsession/start/payment). Например, чтобы вызвать виджет платежной формы или просто сразу получить идентификатор сессии и следить по нему за тем, что происходит с платежом.
Какие карты можно принимать к оплате
Visa, Mastercard и «Мир».
Какие операции можно проводить
- обычные платежи картой,
- платежи с холдированием (сумма замораживается на срок до 5 дней, потом списывается — полностью или частично),
- рекуррентные платежи,
- возвраты (полные и частичные),
- сплит-платежи (платеж разделяется на два, например, часть денег получает магазин за продажу товаров, а часть — курьер за их доставку),
- платежи через SberPay,
- платежи через СБП по QR-коду.
Как безопасно получать данные карты
Если у вас есть сертификат PCI DSS, можно передавать данные карты в открытом виде. Если нет, можно использовать виджет платежной формы.
Сквозной идентификатор карты
Для подключения этой функциональности, обратитесь к вашему менеджеру в Банке 131.
Если у вас нет PCI DSS, но нужно понимать, какую карту использует пользователь и есть ли пересечения между картами пользователей, вы можете использовать сквозной идентификатор карты.
Если у вас несколько проектов (
X-PARTNER-PROJECT), сквозной идентификатор карты может быть одинаковым или разным для каждого. Сообщите вашему менеджеру в Банке 131, какая именно настройка нужна.
Сквозной идентификатор уникальный и формируется из значений номера карты и ее срока действия.
Его значение передается в новом параметре card_id.
Этот параметр может передаваться при проведении платежей, рекуррентных платежей и при возвратах.
Сквозной идентификатор карты нельзя использовать для оплат или для получения всех привязанных карт.
Сквозной идентификатор не замена токена — вы будете получать их вместе.
На каких условиях
Тарифы на эквайринг фиксируются в договоре с Банком, их можно обсудить с менеджером.
С кем мы не работаем
Вы не сможете подключить прием платежей, если продаете оружие или занимаетесь другим бизнесом из этого списка: