مرجع العميل

محفظة Google

أنشئ PaymentsClient لبيئة اختبار أو بيئة تشغيل فعلي.

مثال

mPaymentsClient = Wallet.getPaymentsClient(
  this,
  new Wallet.WalletOptions.Builder()
      .setEnvironment(WalletConstants.ENVIRONMENT_TEST)
      .build()
);

PaymentsClient

برنامج للتفاعل مع واجهات Google Pay API

IsReadyToPayRequest

أنشئ عنصر Java من النوع IsReadyToPayRequest مناسبًا للاستخدام مع PaymentsClient.isReadyToPay().

fromJson(java.lang.String)

يمكنك إنشاء عنصر Java من النوع IsReadyToPayRequest من سلسلة بتنسيق JSON. اطّلِع على مرجع عنصر IsReadyToPayRequest لمعرفة البنية المتوقّعة للسلسلة المقدَّمة بتنسيق JSON.

PaymentDataRequest

أنشئ كائن Java من النوع PaymentDataRequest مناسبًا للاستخدام مع PaymentsClient.loadPaymentData.

fromJson(java.lang.String)

يمكنك إنشاء عنصر Java من النوع PaymentDataRequest من سلسلة بتنسيق JSON. اطّلِع على مرجع عنصر PaymentDataRequest لمعرفة البنية المتوقّعة للسلسلة المقدَّمة بتنسيق JSON.

PaymentData

تعامَل مع ردّ بتنسيق JSON من Google Pay API لاستخدامه في تطبيقك.

toJson()

إخراج ردّ من واجهة برمجة التطبيقات Google Pay كسلسلة بتنسيق JSON اطّلِع على مرجع عنصر PaymentData لمزيد من المعلومات حول بنية عنصر JSON.

PayButton

public void initialize(ButtonOption buttonOptions)

تُستخدَم هذه الطريقة لتهيئة زر الدفع في Google Pay المصمَّم وفقًا لأحدث هوية بصرية لـ Google Pay.

الوسيطات

مثال: إعداد زر الدفع باستخدام إعدادات مخصّصة:

PayButton googlePayPaymentButton = layoutBinding.googlePayPaymentButton;
JSONArray paymentMethods = new JSONArray().put(getBaseCardPaymentMethod());
googlePayPaymentButton.initialize(
       ButtonOptions.newBuilder()
               .setButtonTheme(ButtonConstants.ButtonTheme.DARK)
               .setButtonType(ButtonConstants.ButtonType.BUY)
               .setCornerRadius(100)
               .setAllowedPaymentMethods(paymentMethods.toString())
               .build()
);

public void setVisibility(View view)

تحدّد طريقة الراحة مستوى ظهور زر الدفع.

الوسيطات

مثال:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

يتم استدعاء الطريقة عندما ينقر المستخدم على زر الدفع في Google Pay.

الوسيطات

BasePaymentDataCallbacksService

فئة الخدمة الأساسية التي تستضيف عمليات استدعاء بيانات الدفع التي تبدأها "خدمات Google Play" ضمن مسار PaymentsClient.loadPaymentData(PaymentDataRequest).

يمكنك توسيع نطاق هذه الخدمة في تطبيقك والإعلان عنها في AndroidManifest.xml باستخدام إذن com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE وفلتر الأهداف لـ com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS.

BasePaymentDataCallbacks

صنف أساسي مجرّد يحتوي على معالجات رد الاتصال لبيانات الدفع التي ينفّذها التاجر لإتاحة تعديلات الأسعار الديناميكية وتفويض الدفع.

override fun onPaymentDataChanged(
    intermediatePaymentData: IntermediatePaymentData,
    onCompleteListener: OnCompleteListener<PaymentDataRequestUpdate>
) {
    val paymentDataRequestUpdateJson = handlePaymentDataChanged(intermediatePaymentData.toJson())
    val update = PaymentDataRequestUpdate.fromJson(paymentDataRequestUpdateJson.toString())
    onCompleteListener.complete(update)
}

override fun onPaymentAuthorized(
    paymentData: PaymentData,
    onCompleteListener: OnCompleteListener<PaymentAuthorizationResult>
) {
    val paymentAuthorizationResultJson = handlePaymentAuthorized(paymentData.toJson())
    val result = PaymentAuthorizationResult.fromJson(paymentAuthorizationResultJson.toString())
    onCompleteListener.complete(result)
}

IntermediatePaymentData

تعالِج بيانات عمليات الاستدعاء الوسيطة التي يتم تمريرها إلى BasePaymentDataCallbacks.onPaymentDataChanged.

toJson()

يتم إخراج بيانات طلب معاودة الاتصال كسلسلة بتنسيق JSON. اطّلِع على مرجع عنصر IntermediatePaymentData لمزيد من المعلومات حول بنية عنصر JSON.

getLastSavedState()

تعرض هذه الدالة Bundle الذي يحتوي على الحالة المحفوظة أثناء تكرار دالة رد النداء السابقة.

PaymentDataRequestUpdate

أنشئ عنصر Java من النوع PaymentDataRequestUpdate لعرضه في BasePaymentDataCallbacks.onPaymentDataChanged.

fromJson(java.lang.String)

يمكنك إنشاء عنصر Java من النوع PaymentDataRequestUpdate من سلسلة بتنسيق JSON. اطّلِع على مرجع عنصر PaymentDataRequestUpdate لمعرفة البنية المتوقّعة للسلسلة المقدَّمة بتنسيق JSON.

withUpdatedSavedState(Bundle)

يتم إرفاق حالة معدَّلة Bundle للاحتفاظ بها بين عمليات استدعاء دالة الاستدعاء.

PaymentAuthorizationResult

أنشئ عنصر Java من النوع PaymentAuthorizationResult لعرضه في BasePaymentDataCallbacks.onPaymentAuthorized.

fromJson(java.lang.String)

يمكنك إنشاء عنصر Java من النوع PaymentAuthorizationResult من سلسلة بتنسيق JSON. اطّلِع على مرجع عنصر الاستجابة PaymentAuthorizationResult لمعرفة البنية المتوقّعة للسلسلة المقدَّمة بتنسيق JSON.