Интеграция SDK на стороне приложения

Общая логика покупки

1. Реализуйте получение платежного токена одним из следующих способов:
   • С помощью методов библиотеки Store (рекомендуется):
     • Для покупки одного предмета вызовите метод createOrderByItemSku.
     • Для покупки товаров в корзине:
       1. После наполнения корзины пользователем вызовите метод fillCurrentCartWithItems.
       2. Вызовите метод createOrderFromCartById или createOrderFromCurrentCart.

1. • С помощью Shop Builder API.
   • С помощью собственных серверных методов или методов BaaS-решения.

2. Реализуйте открытие платежного интерфейса:

1val intent = XPayments.createIntentBuilder(this)
2               .accessToken(<accessToken>)
3               .isSandbox(<isSandbox>)
4           	.setStatusReceivedCallback(object : StatusReceivedCallback {
5               	override fun onSuccess(data: InvoicesDataResponse) {
6                   		Log.d(TAG, "StatusReceivedCallback is fired. Result data = $data")
7               	}
8           	})
9           	.build()

Варианты открытия платежного интерфейса

В SDK для Android предусмотрено 3 способа отображения платежного интерфейса внутри приложения:

Настройка способа открытия платежного интерфейса

По умолчанию SDK использует Custom Tabs. Если на устройстве пользователя использование Custom Tabs недоступно, например, если не установлен подходящий браузер, SDK автоматически переключится на другие способы открытия платежного интерфейса. Сначала на WebView, а затем на внешний браузер, установленный на устройстве по умолчанию.

Вы можете установить другой основной способ открытия платежного интерфейса с помощью метода setActivityType.

Пример:

1XPayments.createIntentBuilder(this)
2  .accessToken(AccessToken(token))
3  .isSandbox(BuildConfig.IS_SANDBOX)
4  .setActivityType(ActivityType.TRUSTED_WEB_ACTIVITY)
5  .build()

В случае, если установленный вами способ будет недоступен, SDK будет переключаться на другие варианты в следующем порядке: Trusted Web Activity > Custom Tabs > WebView > внешний браузер, установленный на устройстве по умолчанию.

Настройка кнопки закрытия платежного интерфейса

Мы рекомендуем настроить кнопку закрытия платежного интерфейса, т. к. строка браузера и стандартные элементы навигации не видны пользователю в WebView и Trusted Web Activity. Для этого в объекте PaymentOptions в параметре ui.mobile передайте объект mobile = UiMobileProjectSettingHeader с параметром closeButton=true.

Вы можете выбрать значок, который будет отображаться на кнопке. Для этого передайте в параметре closeButtonIcon:

• “arrow” — для отображения значка ←;
• “cross” — для отображения значка × (по умолчанию).

Пример объекта PaymentOptions:

 1val paymentOptions = PaymentOptions(
 2            isSandbox = isSandbox,
 3            settings = PaymentProjectSettings(
 4                ui = UiProjectSetting(mobile = MobileSettings(header = UiMobileProjectSettingHeader(closeButton = true, closeButtonIcon = "arrow"))),
 5                returnUrl = "app://xpayment.${getApplication<Application>().packageName}",
 6                redirectPolicy = SettingsRedirectPolicy(
 7                    redirectConditions = "any",
 8                    delay = 5,
 9                    statusForManualRedirection = "any",
10                    redirectButtonCaption = "Back to the Game"
11                )
12            )
13        )

Пример использования параметров closeButton и closeButtonIcon в WebView и Trusted Web Activity: