Müşteri referansı

Bu referansta, web uygulamalarınızda Google Pay API'yi uygulamak için kullanacağınız 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ılabilen 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 stilize edilmiş bir Google Pay ödeme düğmesi oluşturmak üzere 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ı için uygun düğme rengini ve düğme türünü seçme hakkında daha fazla bilgi edinmek için Marka yönergelerimize göz atın. Düğmenin boyutlarını, sayfanızdaki benzer düğmelerle veya ödeme öğeleriyle eşleşecek şekilde değiştirmeniz gerekebilir. Kullanım alanınız için bir düğme yapılandırmak üzere Düğmenizi özelleştirin aracımızı kullanın.

Bağımsız değişkenler

Ad Açıklama
options

Bir 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 bir HTML <button>.

Verdiği hatalar

Tür Açıklama
Error

Gerekli bir özellik ayarlanmamış.

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.

Tarayıcı Google Pay'i destekliyorsa isReadyToPay, true değerini döndürür. Kullanıcının bir Google Hesabı'nda oturum açıp açmadığını veya Google Pay'e bir ödeme yöntemi kaydedip kaydetmediğini belirlemek için IsReadyToPayRequest.existingPaymentMethodRequired değerini true olarak ayarlayın ve çözümlenen sözde paymentMethodPresent değerinin true 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ı özellikler hakkında ayrıntılı bilgi için IsReadyToPayRequest başlıklı makaleyi inceleyin.

İadeler

Tür Açıklama
Promise

Çözüldü: Kullanıcının ödeme yapma durumuyla ilgili bilgileri 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ır olup olmadığını 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 karşılamamayı 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ışı işlerken çağrılmalıdır. Kullanıcıya, ödeme yöntemi seçmesi veya iletilen istek parametresinde belirtilen diğer gerekli verileri girmesi 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 tüketici verilerini içeren bir nesne. Daha fazla bilgi için PaymentData bölümüne 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ş yapılan Google kullanıcısı desteklenmiyor.
  • Tüketici, ödeme yetkilendirmesi olmadan Google Pay ödeme sayfasını kapattı.
  • İ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ı. En sık karşılaşılan neden, güvenli olmayan bir tarayıcı bağlamıdır.
  • Google Pay ödeme sayfası zaten gösterilirken yöntem çağrıldı.
  • Geçirilen PaymentDataRequest nesnesi, Google Pay ödeme sayfası tarafından reddedildi. Ağ geçidiniz için PaymentMethodTokenizationSpecification parametrelerinin eksik olması veya tamamlanmaması ya da geçersiz parametre değerleri, yaygın bir nedendir.
DEVELOPER_ERROR İletilen PaymentDataRequest nesnesi yanlış biçimlendirilmiş, gerekli minimum parametreler eksik veya geçersiz bir parametre ve/veya değer içeriyor.

prefetchPaymentData(paymentDataRequest)

Bu yöntemi kullanarak PaymentDataRequest yapılandırmayı önceden getirin ve sonraki kullanıcı etkileşiminde loadPaymentData yürütme süresini kısaltı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ğindeki bir değişiklik, önceden getirme için önbelleğe alınan değeri etkilemez.

Ödeme verileri geri çağırmaları

Aşağıdaki geri çağırma işleyicileri, Ödemeleri Yetkilendirme ve Dinamik Fiyat Güncellemeleri'ni desteklemek için PaymentOptions.paymentDataCallbacks iletilebilir.

onPaymentAuthorized(paymentData)

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

gösterir.

Bağımsız değişkenler

Ad Açıklama
paymentData İstenen alışveriş yapan kullanıcı 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ıyla ilgili bilgileri içeren bir nesne. Ayrıntılı bilgi için PaymentAuthorizationResult başlıklı makaleyi inceleyin.

Reddedildi: Ödeme sayfasında oluşturulacak 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

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 verileri hataları hakkında bilgi içeren bir nesne. Ayrıntılı bilgi için PaymentDataRequestUpdate başlıklı makaleyi inceleyin.

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