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