Как открыть платежный интерфейс в мобильном приложении
Примечание
Для быстрой интеграции сервисов Xsolla вы можете использовать Xsolla Mobile SDK — рекомендуемый вариант, чтобы расширить набор способов оплаты и при этом соблюдать требования мобильных маркетплейсов.
- В браузере — в этом случае пользователь будет перенаправлен из игры во внешний браузер для совершения оплаты. Платежный интерфейс будет выглядеть следующим образом:
- В Android WebView — в этом случае платежный интерфейс открывается внутри игрового приложения и выглядит частью приложения:
- В пользовательских вкладках (Custom Tabs) — в этом случае платежный интерфейс открывается внутри игрового приложения, но пользователь видит строку браузера. Платежный интерфейс будет выглядеть следующим образом:
В браузере
Чтобы открыть платежный интерфейс в браузере и принимать платежи любыми способами, которые поддерживает Xsolla, воспользуйтесь инструкцией по открытию платежного интерфейса.
В Android WebView
Android WebView — это предустановленный системный компонент от Google, с помощью которого приложения Android могут показывать контент. Для корректной работы платежного интерфейса в Android WebView вам необходимо настроить WebView и реализовать методы setWebViewClient и setWebChromeClient.
Copy
- java
1mWebView.setWebViewClient(new XsollaWebViewClient(this));
2mWebView.setWebChromeClient(new XsollaWebChromeClient(this));
Чтобы настроить открытие платежного интерфейса в Android WebView:
- Настройте WebView согласно примеру:
Copy
- java
1WebSettings webSettings = mWebView.getSettings();
2webSettings.setBuiltInZoomControls(false);
3webSettings.setUseWideViewPort(true);
4webSettings.setDomStorageEnabled(true);
5webSettings.setLoadWithOverviewMode(true);
6webSettings.setJavaScriptEnabled(true);
7webSettings.setSupportMultipleWindows(true);
8webSettings.setJavaScriptCanOpenWindowsAutomatically(true);
- Добавьте класс
XsollaWebViewClient, который наследуется от классаWebViewClientи переопределяет методыshouldOverrideUrlLoadingиonPageFinishedсогласно примеру:
Copy
- java
1class XsollaWebViewClient extends WebViewClient {
2 private final Context context;
3
4
5 public XsollaWebViewClient(Context context) {
6 this.context = context;
7 }
8
9
10 @Override
11 public boolean shouldOverrideUrlLoading(WebView view, String url) {
12 if(url.matches(".+://.*")) {
13 try {
14 Intent intent = Intent.parseUri(url, Intent.URI_INTENT_SCHEME);
15 intent.addCategory("android.intent.category.BROWSABLE");
16 intent.setComponent(null);
17 context.startActivity(intent);
18 } catch(URISyntaxException e) {
19 Log.e("WebView", "Invalid URL format" + url, e);
20 } catch (ActivityNotFoundException e) {
21 Log.e("WebView", "No activity found to handle URL: " + url, e);
22 }
23 return true;
24 }
25
26
27 return false;
28 }
29
30
31 @Override
32 public void onPageFinished(WebView view, String url) {
33 super.onPageFinished(view, url);
34 }
35}
- Добавьте класс
XsollaWebChromeClient, который наследуется от классаWebChromeClientи переопределяет методыonCreateWindowиonCloseWindowв этом классе.
Copy
- java
1public class XsollaWebChromeClient extends WebChromeClient {
2 private final Context mContext;
3
4 public XsollaWebChromeClient(Context context) {
5 mContext = context;
6 }
7
8 @Override
9 public boolean onCreateWindow(WebView view, boolean isDialog, boolean isUserGesture, android.os.Message resultMsg) {
10 MainActivity mainActivity = (MainActivity) mContext;
11
12 WebView.WebViewTransport transport = (WebView.WebViewTransport) resultMsg.obj;
13 transport.setWebView(mainActivity.mChildWebView);
14 resultMsg.sendToTarget();
15 return true;
16 }
17}
- Добавьте класс
XsollaChildWebView, который наследуется от классаWebView.
Copy
- java
1public class XsollaChildWebView extends WebView {
2
3
4 @SuppressLint("SetJavaScriptEnabled")
5 public XsollaChildWebView(Context context, AttributeSet attrs) {
6 super(context, attrs);
7
8
9 WebSettings webSettings = getSettings();
10 webSettings.setJavaScriptEnabled(true);
11 webSettings.setDomStorageEnabled(true);
12
13
14 setWebViewClient(new XsollaWebViewClient(context));
15 setWebChromeClient(new XsollaWebChromeClient(context));
16 }
17}
- Объявите переменную
mChildWebViewкак поле классаMainActivity:
Copy
- java
1mChildWebView = findViewById(R.id.childWebView);
Второй WebView (childWebView) используется для открытия новых окон в платежном интерфейсе:
Пример реализации
Copy
- xml
1<?xml version="1.0" encoding="utf-8"?>
2<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
3 xmlns:app="http://schemas.android.com/apk/res-auto"
4 xmlns:tools="http://schemas.android.com/tools"
5 android:layout_width="match_parent"
6 android:layout_height="match_parent"
7 tools:context=".MainActivity">
8
9 <WebView
10 android:id="@+id/mainWebView"
11 android:layout_width="match_parent"
12 android:layout_height="match_parent"
13 app:layout_constraintBottom_toBottomOf="parent"
14 app:layout_constraintEnd_toEndOf="parent"
15 app:layout_constraintStart_toStartOf="parent"
16 app:layout_constraintTop_toTopOf="parent" />
17
18 <com.example.app.XsollaChildWebView
19 android:id="@+id/childWebView"
20 android:layout_width="match_parent"
21 android:layout_height="match_parent"
22 android:visibility="gone"
23 app:layout_constraintBottom_toBottomOf="parent"
24 app:layout_constraintEnd_toEndOf="parent"
25 app:layout_constraintStart_toStartOf="parent"
26 app:layout_constraintTop_toTopOf="parent" />
27
28</androidx.constraintlayout.widget.ConstraintLayout>
Примечание
Вы можете найти подробные примеры кода в репозитории на GitHub.
В пользовательских вкладках (Custom Tabs)
Пользовательские вкладки (Custom Tabs) — это функциональность браузеров Android, которая позволяет добавлять кастомизированные возможности браузера напрямую в приложение. Разница между WebView и Custom Tabs в том, что действия пользователя в WebView изолированы от других действий пользователя в интернете, в то время как использование Custom Tabs позволяет синхронизировать действия пользователя с его другой активностью в Chrome на устройстве Android.
Пример кода для открытия платежного интерфейса в Custom Tabs:
Copy
- java
1String url = "https://secure.xsolla.com/paystation4?token=${token}";
2CustomTabsIntent.Builder builder = new CustomTabsIntent.Builder();
3CustomTabsIntent customTabsIntent = builder.build();
4customTabsIntent.launchUrl(this, Uri.parse(url));
Была ли статья полезна?
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.
