Müşteri referansı

Bu referansta, web uygulamalarınızda Google Pay API'yi uygulamak için kullanılacak JavaScript istemci yöntemleri açıklanmaktadır.

Marka

PaymentsClient nesnesini başlatır. Üye yöntemlerini çağırmadan önce bu oluşturucuyu çağırmanız gerekir.

new PaymentsClient(paymentOptions)

Bağımsız değişkenler

Mülk Açıklama
paymentOptions

Google Pay API yapılandırma verilerinin anahtar/değer çiftlerini içeren bir nesne. Yapılandırılabilir farklı özellikler için PaymentOptions bölümüne bakın.

Örnek: {environment:'PRODUCTION'}

İadeler

Tür Açıklama
google.payments.api.PaymentsClient PaymentsClient nesnesi.

Verdiği hatalar

Tür Açıklama
Error

Geçirilen ortam özelliği değeri desteklenmiyor.

Nesne yöntemleri

createButton(options)

Kolaylık yöntemi, bir web sayfasına eklemek için en yeni Google Pay markasıyla tasarlanmış bir Google Pay ödeme düğmesi oluşturmak amacıyla kullanılır.

Oluşturulan HTMLElement, dinamik olarak eklenen CSS ve Google'ın CDN'sinde barındırılan bir SVG resmi içerir.

Sitenizin tasarımına uygun düğme rengini ve düğme türünü nasıl seçeceğiniz hakkında daha fazla bilgi için Marka kurallarımıza göz atın. Düğmenin boyutlarını, sayfanızdaki benzer düğmelere veya ödeme öğelerine uyacak şekilde değiştirmeniz gerekebilir. Kullanım alanınıza uygun bir düğme yapılandırmak için Düğmenizi özelleştirin aracımızı kullanın.

Bağımsız değişkenler

Ad Açıklama
options

Düğme yapılandırması için anahtar/değer çiftleri içeren bir nesne. Yapılandırılabilir özellikler için ButtonOptions bölümüne bakın.

Örnek: {onClick:onGooglePaymentButtonClicked}

İadeler

Tür Açıklama
HTMLElement <div> gibi genel bir akış içeriği kapsayıcısının içindeki HTML <button>.

Verdiği hatalar

Tür Açıklama
Error

Gerekli bir özellik ayarlanmamış.

isReadyToPay(isReadyToPayRequest)

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

Tarayıcı Google Pay'i destekliyorsa isReadyToPay, true değerini döndürür. Kullanıcının bir Google Hesabı'na giriş yapıp yapmadığını veya Google Pay'e bir ödeme yöntemi kaydedip kaydetmediğini belirlemek için IsReadyToPayRequest.existingPaymentMethodRequired değerini true olarak ayarlayın ve paymentMethodPresent değerinin, çözümlenen promise'de true değerini döndürdüğünü doğrulayın. Daha fazla bilgi için IsReadyToPayResponse başlıklı makaleyi inceleyin.

PaymentsClient, TEST ortam özelliğiyle başlatılırsa paymentMethodPresent her zaman true değerini döndürür.

Bağımsız değişkenler

Ad Açıklama
isReadyToPayRequest Satıcı tarafından desteklenen ödeme yöntemlerini içeren bir nesne. Yapılandırılabilen farklı özelliklerle ilgili ayrıntılar için IsReadyToPayRequest başlıklı makaleyi inceleyin.

İadeler

Tür Açıklama
Promise

Resolved: Kullanıcının ödeme yapma durumu hakkında bilgi içeren bir nesne. Daha fazla bilgi için IsReadyToPayResponse konusuna bakın.

Reddedildi: Reddedilme nedeni hakkında daha fazla bilgi içeren bir hata nesnesi. Daha fazla bilgi için PaymentsError konusuna bakın.

Hatalar

statusCode Açıklama
DEVELOPER_ERROR
  • Geçirilen IsReadyToPayRequest nesnesi yanlış biçimlendirilmiş, kullanıcının ödeme yapmaya hazırlık durumunu belirlemek için gereken minimum parametreleri içermiyor veya geçersiz bir parametre ve/veya değer içeriyor.
  • İstek, ödeme aracısının veya tarayıcının yerine getirmemeyi seçtiği bir güvenlik bağlamından başlatıldı. Bu hata genellikle güvenli olmayan tarayıcı bağlamı hatasıdır.

loadPaymentData(paymentDataRequest)

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

Bu yöntem, tarayıcı bir tıklama etkinliği sonucunda etkinleştirme davranışını işlerken çağrılmalıdır. Kullanıcıya, iletilen istek parametresinde belirtilen ödeme yöntemini veya diğer gerekli verileri seçmesi için bir pop-up pencere gösterilebilir.

Bağımsız değişkenler

Ad Açıklama
paymentDataRequest Tam Google Pay API yapılandırmasının anahtar/değer çiftlerini içeren bir nesne. Yapılandırılabilir özellikler için PaymentDataRequest bölümüne bakın.

İadeler

Tür Açıklama
Promise

Çözüldü: İstenen alışveriş yapan kullanıcı verilerini içeren bir nesne. Daha fazla bilgi için PaymentData sayfasına bakın.

Reddedildi: Hata kodu ve reddedilme nedeni hakkında daha fazla bilgi içeren bir nesne. Daha fazla bilgi için PaymentsError bölümüne bakın.

Hatalar

statusCode Açıklama
CANCELED
  • Mevcut tarayıcı veya giriş yapmış Google kullanıcısı desteklenmiyor.
  • Alışveriş yapan kullanıcı, ödeme yetkilendirmesi olmadan Google Pay ödeme sayfasını kapattı.
  • İstek, ödeme aracısının veya tarayıcının yerine getirmemeyi tercih ettiği bir güvenlik bağlamından başlatıldı. En yaygın olarak güvenli olmayan bir tarayıcı bağlamı.
  • Google Pay ödeme sayfası gösterilirken yöntem çağrıldı.
  • Geçirilen PaymentDataRequest nesnesi, Google Pay ödeme sayfası tarafından reddedildi. Ağ geçidiniz için eksik veya tamamlanmamış PaymentMethodTokenizationSpecification parametreler ya da geçersiz parametre değerleri yaygın bir nedendir.
DEVELOPER_ERROR Geçirilen PaymentDataRequest nesnesi yanlış biçimlendirilmiş, minimum gerekli parametreleri eksik veya geçersiz bir parametre ve/veya değer içeriyor.

prefetchPaymentData(paymentDataRequest)

Daha sonraki kullanıcı etkileşimlerinde loadPaymentData yürütme süresini iyileştirmek amacıyla PaymentDataRequest yapılandırmasını önceden getirmek için bu yöntemi kullanın. Değer döndürülmez.

Önceden getirme optimizasyonları Android için Chrome'da kullanılabilir.

Bağımsız değişkenler

Ad Açıklama
paymentDataRequest Tam Google Pay API yapılandırmasının anahtar/değer çiftlerini içeren bir nesne. Yapılandırılabilir özellikler için PaymentDataRequest bölümüne bakın. transactionInfo özelliğinde yapılan bir değişiklik, önceden getirme değerinin önbelleğe alınmış halini etkilemez.

Ödeme verileri geri çağırmaları

Ödemeleri yetkilendirme ve dinamik fiyat güncellemelerini desteklemek için aşağıdaki geri çağırma işleyiciler PaymentOptions.paymentDataCallbacks yöntemine iletilebilir.

onPaymentAuthorized(paymentData)

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

Bağımsız değişkenler

Ad Açıklama
paymentData İstenen müşteri verilerini içeren bir nesne. Ayrıntılı bilgi için PaymentData başlıklı makaleyi inceleyin.

İadeler

Tür Açıklama
Promise

Resolved: Ödeme işlemi sonuçları hakkında bilgi içeren bir nesne. Ayrıntılı bilgi için PaymentAuthorizationResult başlıklı makaleyi inceleyin.

Reddedildi: Ödeme sayfasında gösterilecek bir hata amacı ve mesajı içeren hata nesnesi. Ayrıntılı bilgi için PaymentDataError başlıklı makaleyi inceleyin.

onPaymentDataChanged(intermediatePaymentData)

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 Açıklama
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.

İadeler

Tür Açıklama
Promise

Resolved: Yeni işlem bilgileri, kargo seçenekleri ve ödeme verisi hataları hakkında bilgi içeren bir nesne. Ayrıntılı bilgi için PaymentDataRequestUpdate başlıklı makaleyi inceleyin.

Reddedildi: Ödeme sayfasında gösterilecek bir hata amacı ve mesajı içeren hata nesnesi. Ayrıntılı bilgi için PaymentDataError başlıklı makaleyi inceleyin.