Müşteri referansı

com.google.android.gms.wallet documentation, Google Pay API'nin birden fazla sürümünde kitaplığın tam belgelerini içerir. Aşağıda, Google Pay API'nin en son sürümü (sürüm 2.0) için en uygun nesnelerin ve yöntemlerin bir özeti verilmiştir:

Cüzdan

Test veya üretim ortamı için PaymentsClient oluşturun.

Örnek

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

PaymentsClient

Google Pay API'leriyle etkileşim kurmak için kullanılan bir istemci.

isReadyToPay(IsReadyToPayRequest)

Kullanıcının Google Pay API'den bir ödeme şekli döndürüp döndüremeyeceğini belirlemek için isReadyToPay(IsReadyToPayRequest) yöntemini kullanın.

Cihaz Google Pay'i destekliyorsa ve kullanıcı daha önce bir ödeme yöntemi kaydetmişse veya ekleyebiliyorsa IsReadyToPay, true değerini döndürür. Kullanıcının Google Pay'e daha önce bir ödeme yöntemi kaydedip kaydetmediğini belirlemek için IsReadyToPayRequest.existingPaymentMethodRequired değerini true olarak ayarlayın.

loadPaymentData(PaymentDataRequest)

Ödeme yönteminin ve isteğe bağlı olarak yapılandırılmış parametrelerin seçilmesine olanak tanıyan bir Google Pay ödeme sayfası sunun.

IsReadyToPayRequest

PaymentsClient.isReadyToPay() ile kullanıma uygun bir IsReadyToPayRequest Java nesnesi oluşturun.

fromJson(java.lang.String)

JSON biçimli bir dizeden IsReadyToPayRequest Java nesnesi oluşturun. Sağlanan JSON biçimli dizenin beklenen yapısı için IsReadyToPayRequest nesne referansına bakın.

PaymentDataRequest

PaymentsClient.loadPaymentData ile kullanıma uygun bir PaymentDataRequest Java nesnesi oluşturun.

fromJson(java.lang.String)

JSON biçimli bir dizeden PaymentDataRequest Java nesnesi oluşturun. Sağlanan JSON biçimli dizenin beklenen yapısı için PaymentDataRequest nesne referansına bakın.

PaymentData

Uygulamanızda kullanmak üzere Google Pay API JSON biçimli yanıtını işleyin.

toJson()

Google Pay API yanıtını JSON biçimli dize olarak döndürür. JSON nesnesinin yapısı hakkında daha fazla bilgi için PaymentData nesne referansına bakın.

PayButton

public void initialize(ButtonOption buttonOptions)

Kolaylık yöntemi, en yeni Google Pay markasıyla tasarlanmış bir Google Pay ödeme düğmesini başlatmak için kullanılır.

Bağımsız değişkenler

Ad Açıklama
buttonOptions Google Pay ödeme düğmesini yapılandıran bir nesne. Yapılandırılabilir özellikler için ButtonOptions bölümüne bakın.

Örnek: Ödeme düğmesini özel yapılandırmalarla başlatma:

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)

Kolaylık yöntemi, ödeme düğmesinin görünürlüğünü ayarlar.

Bağımsız değişkenler

Ad Açıklama
View

View.VISIBLE, ödeme düğmesini görünür (varsayılan) olarak ayarlar.

View.GONE, düğmeyi kullanıcılardan gizler.

Örnek:

payButton.setVisibility(View.VISIBLE);

public void setOnClickListener(View.OnClickListener listener)

Kullanıcı, Google Pay ödeme düğmesini tıkladığında yöntem çağrılır.

Bağımsız değişkenler

Ad Açıklama
listener Google Pay ödeme düğmesine bir tıklama etkinliği gönderildiğinde çağrılacak etkinlik işleyici geri çağırma işlevi.

BasePaymentDataCallbacksService

PaymentsClient.loadPaymentData(PaymentDataRequest) akışında Google Play Hizmetleri tarafından başlatılan ödeme verileri geri çağırmalarını barındıran temel hizmet sınıfı.

Bu hizmeti uygulamanızda genişletin ve com.google.android.gms.permission.BIND_PAYMENTS_CALLBACK_SERVICE izni ve com.google.android.gms.wallet.callback.PAYMENT_DATA_CALLBACKS için bir intent filtresi ile AndroidManifest.xml dosyanızda beyan edin.

createPaymentDataCallbacks()

Gelen geri çağırma etkinliklerini işlemek için BasePaymentDataCallbacks uygulamasını döndürür. Geri çağırma etkinliği başına bir kez çağrılır.

BasePaymentDataCallbacks

Dinamik fiyat güncellemelerini ve ödeme yetkilendirmesini desteklemek için satıcı tarafından uygulanan ödeme verileri geri çağırma işleyicilerini içeren soyut temel sınıf.

onPaymentDataChanged(intermediatePaymentData, onCompleteListener)

Bu yöntem, ödeme sayfasındaki ödeme verisi değişikliklerini (ör. kargo adresi ve kargo seçenekleri) işler.

Bağımsız değişkenler

merhaba
Ad Tür Açıklama
intermediatePaymentData IntermediatePaymentData Ödeme sayfasında seçilen adresi ve kargo seçeneğini içeren bir nesne. Ayrıntılı bilgi için IntermediatePaymentData başlıklı makaleyi inceleyin.
onCompleteListener OnCompleteListener<PaymentDataRequestUpdate> Güncellenen işlem bilgileri, kargo seçenekleri ve ödeme verisi hatalarıyla çözümlenecek bir dinleyici. complete()'e bir PaymentDataRequestUpdate örneği iletin.

Örnek

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

onPaymentAuthorized(paymentData, onCompleteListener)

Bu yöntem, ödeme sayfasında bir ödeme yetkilendirildiğinde çağrılır.

Bağımsız değişkenler

Ad Tür Açıklama
paymentData PaymentData İstenen müşteri verilerini içeren bir nesne. Ayrıntılı bilgi için PaymentData başlıklı makaleyi inceleyin.
onCompleteListener OnCompleteListener<PaymentAuthorizationResult> Yetkilendirme sonucuyla çözümlenecek bir dinleyici. complete()'e bir PaymentAuthorizationResult örneği iletin.

Örnek

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 yöntemine iletilen ara geri çağırma verilerini işleyin.

toJson()

Geri çağırma isteği verilerini JSON biçimli bir dize olarak döndürür. JSON nesnesinin yapısı hakkında daha fazla bilgi için IntermediatePaymentData nesne referansına bakın.

getLastSavedState()

Önceki geri çağırma iterasyonu sırasında kaydedilen durumu içeren Bundle değerini döndürür.

PaymentDataRequestUpdate

BasePaymentDataCallbacks.onPaymentDataChanged içinde döndürülecek bir PaymentDataRequestUpdate Java nesnesi oluşturun.

fromJson(java.lang.String)

JSON biçimli bir dizeden PaymentDataRequestUpdate Java nesnesi oluşturun. Sağlanan JSON biçimli dizenin beklenen yapısı için PaymentDataRequestUpdate nesne referansına bakın.

withUpdatedSavedState(Bundle)

Geri çağırma çağrıları arasında kalıcı olması için güncellenmiş bir durum Bundle ekler.

PaymentAuthorizationResult

BasePaymentDataCallbacks.onPaymentAuthorized içinde döndürülecek bir PaymentAuthorizationResult Java nesnesi oluşturun.

fromJson(java.lang.String)

JSON biçimli bir dizeden PaymentAuthorizationResult Java nesnesi oluşturun. Sağlanan JSON biçimli dizenin beklenen yapısı için PaymentAuthorizationResult yanıt nesnesi referansına bakın.