استفاده از وب‌نمای Android

برخی‌از کسب‌وکارها به این قابلیت نیاز دارند که بتوانند فرایند تسویه‌حساب وب خود را بااستفاده از WebView در برنامه‌های تلفن همراهشان جاسازی کنند. این راهنما شما را در مراحل لازم برای پشتیبانی از Google Pay در «وب‌نما» پس‌از تکمیل ادغام وب Google Pay راهنمایی می‌کند.

الزامات دستگاه کاربر

تغییرات الزامی برنامه

وقتی فرایند تسویه‌حساب وب در «وب‌نمای Android» جاسازی شده باشد، از Payment Request API برای راه‌اندازی برگه Google Pay استفاده می‌شود. به‌طور پیش‌فرض، میانای برنامه‌سازی کاربردی «درخواست پرداخت» برای «وب‌نما» غیرفعال خواهد شد. تغییرات زیر در کد برنامه‌تان لازم است:

افزودن (یا به‌روزرسانی) وابستگی ساخت:

Groovy

dependencies {
    implementation 'androidx.webkit:webkit:1.14.0'
}

Kotlin

dependencies {
    implementation("androidx.webkit:webkit:1.14.0")
}

کاتالوگ نسخه

[versions]
webkit = "1.14.0"

[libraries]
androidx-ktx = { group = "androidx.webkit", name = "webkit", version.ref = "webkit" }

برچسب‌های <queries> زیر را به AndroidManifest.xml اضافه کنید:

<queries>
  <intent>
    <action android:name="org.chromium.intent.action.PAY"/>
  </intent>
  <intent>
    <action android:name="org.chromium.intent.action.IS_READY_TO_PAY"/>
  </intent>
  <intent>
    <action android:name="org.chromium.intent.action.UPDATE_PAYMENT_DETAILS"/>
  </intent>
</queries>

«میانای برنامه‌سازی کاربردی درخواست پرداخت» را برای «وب‌نمایی» که در «برنامه» خود استفاده می‌کنید فعال کنید.

مطمئن شوید که از عبارت وارد کردن صحیح برای کدی که استفاده می‌کنید استفاده می‌کنید.

Kotlin

import android.webkit.WebSettings;
import android.webkit.WebView;
import androidx.webkit.WebSettingsCompat;
import androidx.webkit.WebViewFeature;

AndroidView(
    factory = {
        // Update WebView settings to allow JavaScript and payment request
        settings.javaScriptEnabled = true
        WebView(it).apply {
            if (WebViewFeature.isFeatureSupported(
                    WebViewFeature.PAYMENT_REQUEST)) {
                WebSettingsCompat.setPaymentRequestEnabled(settings, true);
            }
        }
    },
    update = {it.loadUrl(url)
    }
)

جاوا

import android.webkit.WebSettings;
import android.webkit.WebView;
import androidx.webkit.WebSettingsCompat;
import androidx.webkit.WebViewFeature;

WebView webView = findViewById(R.id.webview);
WebSettings webSettings = webView.getSettings();

// Update WebView settings to allow JavaScript and payment request
webSettings.setJavaScriptEnabled(true);
if (WebViewFeature.isFeatureSupported(
          WebViewFeature.PAYMENT_REQUEST)) {
    WebSettingsCompat.setPaymentRequestEnabled(webSettings, true);
}

انتشار ادغام

برای اینکه برنامه‌تان اجازه داشته باشد از Google Pay در «وب‌نمای Android» استفاده کند، باید راهنمای یکپارچه‌سازی‌تان را منتشر کنید.