Müşteri referansı

com.google.android.gms.wallet documentation Google Pay API'nin birden fazla sürümündeki kitaplıkla ilgili tüm dokümanlar yer alır. Aşağıda, Google Pay API'nin en son sürümü olan 2.0 sürümü için en uygun nesnelerin ve yöntemlerin bir özeti yer almaktadır: 2.0 sürümü

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 istemci.

isReadyToPay(IsReadyToPayRequest)

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

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

loadPaymentData(PaymentDataRequest)

Ödeme yönteminin seçilmesine ve isteğe bağlı olarak yapılandırılmış parametrelere izin veren bir Google Pay ödeme sayfası gösterin.

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 kullanılmak üzere Google Pay API'nin JSON biçimli yanıtını işleyin.

toJson()

Google Pay API yanıtını JSON biçimli bir dize olarak çıkışa aktarın. JSON nesnesinin yapısı hakkında daha fazla bilgi için PaymentData nesne referansı konusuna bakın.

PayButton

public void initialize(ButtonOption buttonOptions)

Kolaylık yöntemi, en yeni Google Pay markasıyla şekillendirilmiş 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'a bakın.

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

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 Tıklama etkinliği, Google Pay ödeme düğmesine teslim edildiğinde çağrılacak bir etkinlik işleyici geri araması.

BasePaymentDataCallbacksService

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

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

createPaymentDataCallbacks()

Gelen geri çağırma etkinliklerini işlemek için BasePaymentDataCallbacks uygulaması 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.

gösterir.

Bağımsız değişkenler

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 verileri hatalarıyla çözümlenecek bir dinleyici. complete()'ye 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 alışveriş yapan kullanıcı 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()'ye 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'a iletilen ara geri arama verilerini işleyin.

toJson()

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

getLastSavedState()

Önceki geri çağırma yinelemesi 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 işlemleri 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ı bölümüne bakın.