ym88659208ym87991671
Режим оплаты карточной связкой | Документация для разработчиков

Режим оплаты карточной связкой

Обновлено 23 сентября 2026

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

Выбор банковской карты

Выбор сохраненной карты для оплаты реализуется на стороне партнера. Покупатель выбирает способ оплаты на экране оформления заказа в приложении партнера, после чего приложение передает идентификатор выбранной связки в SDK.

Способ оплаты: сохраненная карта SberPay •• 2456

Для запуска используется метод pay. Название режима и расположение идентификатора различаются по платформам:

ПлатформаРежим оплатыГде передать идентификатор
AndroidSPayMethod.BindingPaymentbindingId в SPayMethod.BindingPayment(bindingId = bindingId)
iOSSPayMethod.bindingPaymentbindingId в SPaymentRequest

Примеры вызова: Android — оплата связкой, iOS — оплата связкой.

SPayMethod.WithBinding на Android и SPayMethod.withBinding на iOS помечены как устаревшие. Для описанного сценария используются BindingPayment и bindingPayment соответственно.

Подтверждение операции

Оплата может выполняться без дополнительного подтверждения или потребовать подтверждения ОТП-кодом либо по 3-D Secure. Покупатель выполняет шаги, которые показывает SDK в ходе конкретной операции.

Подтверждение ОТП-кодом

При необходимости ОТП-верификации для SberPay-связки покупатель вводит код из СМС на экране SDK.

Подтверждение оплаты связкой кодом из СМС

Подтверждение 3-D Secure

Если требуется подтверждение по 3-D Secure, внутри интерфейса оплаты открывается форма банка для ввода кода. Покупатель вводит код подтверждения, после чего SDK продолжает обработку платежа.

Форма банка для подтверждения оплаты по 3-D Secure

Процесс оплаты

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

Не удалось оплатить связкой по карте Сбера

Если для оплаты была выбрана карта Сбера, но оплатить связкой не удалось, например из-за недостаточного баланса, SDK показывает экран «Не удалось оплатить» и предлагает оплатить другой картой.

Неуспешная оплата сохраненной картой

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

Выбор другой карты после ошибки оплаты

Дальнейший путь описан в разделе Стандартный режим оплаты.

Завершение сценария

При успешной оплате связкой SDK показывает экран «Оплачено связанной картой» с кнопкой «Закрыть».

Успешная оплата связанной картой

После закрытия шторки покупатель возвращается на экран приложения партнера. Приложение обрабатывает результат вызова pay: на Android — PaymentResult.Success, PaymentResult.Processing, PaymentResult.Error или PaymentResult.Cancel; на iOS — состояния success, waiting, error или cancel в completion-обработчике. При Processing или waiting итог оплаты еще не подтвержден; согласно FAQ, партнеру следует проверить статус платежа со своего сервера.

Описание результатов и ссылки на нативные примеры приведены в завершении стандартного сценария.

Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке