Первые шаги работы с SDK

Обновлено 26 декабря 2025

Для использования SDK на платформе React-Native необходимо внедрить в Ваш React проект нативные SDK для iOS и Android. Данный раздел содержит пример внедрения SDK, который поможет Вам с интеграцией SDK SberPay.

Демо-приложение

Демо-приложение с примером интеграции SDK находится по ссылке . Код приложения можно использовать как референс при интеграции.

Интерфейсы

Для взаимодействия с SDK в проект необходимо перенести файл SPayBridgeModule.tsx. В нем содержится класс, способный обращаться к нативным методам SDK на iOS и Android. Для использования SPayBridgeModule необходимо импортировать его:

import SPayBridgeModule from './SPayBridgeModule';

Скачать файл можно по ссылке .

Класс SPayBridgeModule содержит в себе следующие методы:

setupSDK

Необходимо вызывать метод setupSDK на старте приложения.

Параметры функции преставлены ниже.

Параметр	Тип	Дефолтное значение	Описание
bnplPlan	boolean	true	Функционал Оплата частями
helpers	boolean	true	Функционал helpers.
resultViewNeeded	boolean	true	Отображение экранов со статусом.
needLogs	boolean	true	Выведение логов в консоль в режиме песочницы.
helperConfig	SBHelperConfig	нет	Настройки функционала helpers.
environment	string	prod	Выбор окружения sdk для тестирования. Доступны 3 состояния: sandboxWithoutBankApp, sandboxRealBankApp, prod

Если вы подключили сервис Плати частями и пользователь выбрал этот способ для оплаты заказа, то выполняя через back расширенный запрос состояния заказа getOderStatusExtended.do, в ответе вы получите значение параметра paymentWay равное BNPL. Подключить параметр paymentWay в callback-уведомлениях возможно в личном кабинете партнера интернет-эквайринга. Это можно сделать в настройках->основные настройки->callback-уведомления. При заполнении доп. параметров выйдет список всех возможных. Для того, чтобы передавался способ оплаты заказа необходимо выбрать paymentWay. Оплаченные частями заказы в личном кабинете партнера интернет-эквайринга будут отмечаться признаком BNPL в поле «Платежное средство». При этом денежные средства по заказам, оплаченным частями, поступят от ООО «ЦНФС» («Центр новых финансовых сервисов»), предоставляющей сервис.

Helpers - функционал, позволяющий клиенту с недостаточным количеством средств быстро пополнить счет или выпустить новые продукты для оплаты.

Настройки SBHelperConfig

Параметр	Тип	Дефолтное значение	Описание
sbp	boolean	true	Разрешить пополнение карты через СБП
creditCard	boolean	true	Разрешить выпуск кредитной карты
debitCard	boolean	true	Разрешить выпуск дебетовой карты

Пример использования:

  var testSetupParams = {
    'bnplPlan': true,
    'resultViewNeeded': true,
    'helpers': true,
    'needLogs': true,
    'sbp': false,
    'creditCard': true,
    'debitCard': false
  }

  SPayBridgeModule.setupSDK(
    testSetupParams,
    (errorString: string) => {
      if(errorString) {
        ///
      }
      ///
    }
  )

isReadyForSPay

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

Если метод вернул false, то кнопку оплаты sberpay отрисовывать не следует.

Пример использования:

  SPayBridgeModule.isReadyForSPay( 
    (isReady: boolean) => {
    // ...
  })