Bu referansta, web sitenizde kullanabileceğiniz Google Pay API yanıt nesnesi seçenekleri açıklanmaktadır. Yanıt nesneleri, Google Pay API istemci yöntemleri tarafından döndürülen nesnelerdir.
IsReadyToPayResponse
Bu nesne, bir web sitesi ziyaretçisinin ödeme bilgilerini isteyen siteye sağlama özelliği hakkında bilgi verir.
| Mülk | Tür | Her zaman var | Açıklama |
|---|---|---|---|
result |
boole | Evet | Mevcut ziyaretçi, ödeme bilgilerini isteyen siteye sağlayabilir. Bir ziyaretçinin ödeme yapabilmesi, web tarayıcısının belirtilen ödeme yöntemleri için gerekli bileşenleri görüntüleme özelliğiyle bağlantılı olabilir. Kullanıcıların Google Hesabı'na giriş yapması ve ödeme yöntemi sağlaması buna dahildir. |
paymentMethodPresent |
boole | Hayır |
Yalnızca
|
Örnek
Aşağıdaki örnekte, mevcut ziyaretçinin ödeme bilgilerini isteyen siteye ne zaman sağlayabileceği gösterilmektedir.
{ "result": true }
PaymentData
Bu, ödeme yapan kullanıcı ödemeyi onayladıktan sonra Google tarafından döndürülen bir yanıt nesnesidir.
PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.| Mülk | Tür | Her zaman var | Açıklama |
|---|---|---|---|
apiVersion |
sayı | Evet | Ana API sürümü. Yanıtın değeri,
PaymentDataRequest içinde sağlanan değerle eşleşiyor. |
apiVersionMinor |
sayı | Evet | Küçük API sürümü. Yanıtın değeri,
PaymentDataRequest içinde sağlanan değerle eşleşiyor. |
paymentMethodData |
PaymentMethodData | Evet | Seçilen ödeme yöntemiyle ilgili veriler. |
email |
dize | Hayır | emailRequired,
PaymentDataRequest içinde true olarak ayarlanmışsa e-posta adresi.
Başka bir istekte özellik true olarak ayarlanmışsa herhangi bir etkisi olmaz. |
shippingAddress |
Adres | Hayır | shippingAddressRequired, true olarak ayarlanmışsa kargo adresi
PaymentDataRequest. |
Örnek
Google Pay API 2.0 sürümü için bu örnek yanıtta, Google Pay ödeme sayfasında seçilen bir CARD ödeme yöntemi gösterilmektedir. example ağ geçidi için bir ödeme yöntemi jetonu oluşturuldu.
{ "apiVersion": 2, "apiVersionMinor": 0, "paymentMethodData": { "type": "CARD", "description": "Visa •••• 1234", "info": { "cardNetwork": "VISA", "cardDetails": "1234", "cardFundingSource": "CREDIT" }, "tokenizationData": { "type": "PAYMENT_GATEWAY", "token": "examplePaymentMethodToken" } } }
IntermediatePaymentData
Bu nesne, ödeme sayfasında kargo adresi veya kargo seçenekleri değiştirildiğinde Google Pay API onPaymentDataChanged() girişi tarafından döndürülür.
| Mülk | Tür | Gereklilik | Açıklama |
|---|---|---|---|
callbackTrigger |
Dize | İsteğe bağlı | Ödeme verileri geri aramasının çağrılma nedenini açıklar.
|
offerData |
OfferData | İsteğe bağlı | Kullanıcı tarafından sağlanan promosyon kodu. |
shippingAddress |
IntermediateAddress | İsteğe bağlı | Ödeme sayfasında seçilen adres. |
shippingOptionData |
SelectionOptionData | İsteğe bağlı | Ödeme sayfasında seçilen kargo seçeneği. |
Örnek
Bu örnekte, Google Pay API'den döndürülen ara yük gösterilmektedir.
{ "callbackTrigger": "SHIPPING_ADDRESS", "offerData": { "redemptionCode": "exampleCode" }, "shippingAddress": { "administrativeArea": "NY", "countryCode": "US", "locality": "New York", "postalCode": "10011" }, "shippingOptionData": { "id": "shipping-001" } }
PaymentMethodData
Bu nesne, seçilen ödeme yöntemiyle ilgili verileri sağlar.
| Mülk | Tür | Her zaman var | Açıklama |
|---|---|---|---|
type |
dize | Evet |
PaymentMethod
Google Pay ödeme sayfasında type seçilmelidir.
|
description |
dize | Evet | Bu işlemi finanse eden ödeme yöntemini açıklayan, kullanıcıya yönelik mesaj. |
info |
nesne | Evet | Bu özelliğin değeri, type döndürülen ödeme yöntemine bağlıdır.
CARD için CardInfo başlıklı makaleyi inceleyin.
|
tokenizationData |
PaymentMethodTokenizationData | Hayır | Seçilen ödeme yönteminin ödeme jetonu oluşturma verileri. |
Örnek
Bu örnek yanıtta, Google Pay ödeme sayfasında seçilen bir CARD ödeme yönteminin, example ağ geçidi için nasıl ödeme yöntemi jetonu oluşturduğu gösterilmektedir.
{ "type": "CARD", "description": "Visa •••• 1234", "info": { "cardNetwork": "VISA", "cardDetails": "1234" }, "tokenizationData": { "type": "PAYMENT_GATEWAY", "token": "examplePaymentMethodToken" } }
CardInfo
Bu nesne, seçilen ödeme kartı hakkında bilgi sağlar.
| Mülk | Tür | Her zaman var | Açıklama |
|---|---|---|---|
cardDetails |
dize | Evet | Kartla ilgili ayrıntılar. Bu değer genellikle seçilen ödeme hesabı numarasının son dört hanesidir. |
assuranceDetails |
AssuranceDetailsSpecifications | Evet | Bu nesne, assuranceDetailsRequired,
CardParameters içinde true olarak ayarlanmışsa döndürülen ödeme verileri üzerinde gerçekleştirilen doğrulama hakkında bilgi sağlar.
|
cardNetwork |
dize | Evet | Seçilen ödemenin ödeme kartı ağı.
Döndürülen değerler,
CardParameters içindeki Bu kart ağı değeri, alıcıya gösterilmemelidir. Alıcının kartıyla ilgili ayrıntılar gerektiğinde kullanılır. Örneğin, müşteri desteğinin, alıcının işlemi için kullandığı kartı tanımlamak üzere bu değere ihtiyacı varsa. Kullanıcı tarafından görülebilen bir açıklama için bunun yerine PaymentMethodData'nın |
billingAddress |
Adres | Hayır | billingAddressRequired,
CardParameters içinde true olarak ayarlanmışsa sağlanan ödeme yöntemiyle ilişkili fatura adresi.
|
cardFundingSource |
dize | Evet | Seçilen ödeme yöntemi için kart fon kaynağı.
|
Örnek
Bu örnekte Visa ağındaki bir kart gösterilmektedir.
{ "cardNetwork": "VISA", "cardDetails": "1234", "cardFundingSource": "CREDIT", "assuranceDetails": { "cardHolderAuthenticated": false, "accountVerified": true } }
AssuranceDetailsSpecifications
Bu nesne, döndürülen ödeme kimlik bilgilerinde hangi doğrulamanın yapıldığı hakkında bilgi sağlar. Böylece uygun araç risk kontrolleri uygulanabilir.
| Ad | Tür | Açıklama |
|---|---|---|
accountVerified |
boole | true ise döndürülen ödeme kimlik bilgisinde Cardholder sahiplik doğrulamasının yapıldığını gösterir. |
cardHolderAuthenticated |
boole |
|
assuranceDetails alanını kullanmasanız bile yanıt nesnesini alıp işleyebilirsiniz. Bu nesneyi almak için assuranceDetailsRequired: true öğesini, İstek nesnesinin
CardParameters bölümüne ekleyin.
PaymentMethodTokenizationData
Bu nesne, ödeme yöntemi için belirteç oluşturma verileri sağlar.
| Mülk | Tür | Her zaman var | Açıklama |
|---|---|---|---|
type |
dize | Evet | Seçilen ödeme yöntemine uygulanacak jetonlaştırma türü.
Bu değer,
PaymentMethodTokenizationSpecification içinde ayarlanan type ile eşleşir.
|
token |
dize | Hayır | Oluşturulan ödeme yöntemi jetonu.
|
Örnek
Bu, example ağ geçidi için hazırlanmış, jetonlaştırılmış bir yanıt örneğidir.
{ "type": "PAYMENT_GATEWAY", "token": "examplePaymentMethodToken" }
PaymentAuthorizationResult
Bu nesne, ödeme yetkilendirme sonucu hakkında bilgi sağlar.
| Mülk | Tür | Gereklilik | Açıklama |
|---|---|---|---|
transactionState |
Dize | Zorunlu | İşlemin durumu aşağıdaki satıcı sonuçlarından biriyle belirlenir:
|
error |
PaymentDataError | İsteğe bağlı | Ödemenin yeniden denenmesi gerektiğinde kullanıcının ödeme sayfasında oluşturulacak hata. |
Örnek
Aşağıdaki örnekte, ödeme işlendikten sonra döndürülen ödeme sonucu gösterilmektedir:
{ "transactionState": "ERROR", "error": { "reason": "PAYMENT_DATA_INVALID", "message": "Cannot pay with payment credentials", "intent": "PAYMENT_AUTHORIZATION" } }
PaymentDataError
| Mülk | Tür | Gereklilik | Açıklama |
|---|---|---|---|
reason |
Dize | Zorunlu | Önceden tanımlanmış hata nedenlerinin listesi:
|
message |
Dize | Zorunlu | Kullanıcıya gösterilen hata mesajı. |
intent |
Dize | Zorunlu | Hatayla ilgili amaç. Bu, akışın başlangıcından itibaren
|
Örnek
Bu örnekte, ödeme sayfasında oluşturulacak hata amacı ve mesajı gösterilmektedir.
{ "error": { "reason": "SHIPPING_OPTION_INVALID", "message": "This shipping option is invalid for the given address", "intent": "SHIPPING_OPTION" } }
Adres
Bu nesne, istenen posta adresi hakkında bilgi sağlar. Tüm özellikler dizedir.
Adresler MIN, FULL ve FULL-ISO3166 biçimlerinde döndürülebilir. Her biçime ait özellikler aşağıdaki tabloda görülebilir.
| Mülk | Adres biçimi | Açıklama |
|---|---|---|
name |
MIN, FULL ve FULL-ISO3166 |
Alıcının tam adı. |
postalCode |
MIN, FULL ve FULL-ISO3166 |
Posta kodu |
countryCode |
MIN, FULL ve FULL-ISO3166 |
ISO 3166-1 alfa-2 ülke kodu. |
phoneNumber |
MIN, FULL ve FULL-ISO3166 |
phoneNumberRequired,
PaymentDataRequest içinde true olarak ayarlanmışsa telefon numarası.
|
address1 |
FULL, FULL-ISO3166 |
Adresin ilk satırı. |
address2 |
FULL, FULL-ISO3166 |
Adresin ikinci satırı. |
address3 |
FULL, FULL-ISO3166 |
Adresin üçüncü satırı. |
locality |
FULL, FULL-ISO3166 |
Şehir, kasaba, mahalle veya banliyö. |
administrativeArea |
FULL, FULL-ISO3166 |
Eyalet veya il gibi bir ülke alt bölümü. |
sortingCode |
FULL, FULL-ISO3166 |
Sıralama kodu. |
iso3166AdministrativeArea |
FULL-ISO3166 |
administrativeArea'ya karşılık gelen ISO 3166-2 bağlı olduğu yer kodu. |
Örnek
Bu, Amerika Birleşik Devletleri'nde birden fazla sokak adresi verisi satırı içeren örnek bir FULL-ISO3166 biçimli adrestir.
{ "name": "John Doe", "address1": "c/o Google LLC", "address2": "1600 Amphitheatre Pkwy", "address3": "Building 40", "locality": "Mountain View", "administrativeArea": "CA", "countryCode": "US", "postalCode": "94043", "sortingCode": "" "iso3166AdministrativeArea": "US-CA" }
IntermediateAddress
Ara adres, kullanıcının ödemeyi yetkilendirmesinden önce geçerli vergi ve kargo seçeneklerinin hesaplanmasına olanak tanımak için karartılmış bir kargo adresi (sokak düzeyinde adres satırları veya alıcı adları olmadan) içerir.
| Mülk | Tür | Gereklilik | Açıklama |
|---|---|---|---|
administrativeArea |
Dize | Zorunlu | Eyalet veya il gibi bir ülke alt bölümü. |
countryCode |
Dize | Zorunlu | ISO 3166-1 alfa-2 ülke kodu. |
locality |
Dize | Zorunlu | Şehir, kasaba, mahalle veya banliyö. |
postalCode |
Dize | Zorunlu | Ülkeye göre sansürlenmiş posta kodu. Kanada ve Birleşik Krallık için yalnızca ilk üç karakteri içerir. ABD için bu, ilk beş haneyi içerir. |
iso3166AdministrativeArea |
Dize | İsteğe bağlı |
administrativeArea'ya karşılık gelen ISO 3166-2 bağlı olduğu yer kodu. Yalnızca kargo adresi biçimi FULL-ISO3166 ise mevcut olur.
|
Örnek
Bu örnekte, ödeme sayfasında seçilen adres gösterilmektedir.
{ "administrativeArea": "NY", "countryCode": "US", "locality": "New York", "postalCode": "10011" "iso3166AdministrativeArea": "US-NY" }
SelectionOptionData
| Mülk | Tür | Gereklilik | Açıklama |
|---|---|---|---|
id |
Dize | Zorunlu | SelectionOption.id ile eşleşmeler |
Örnek
Bu örnekte, ödeme sayfasında seçilen kargo seçeneği gösterilmektedir.
{ "id": "shipping-001" }
OfferData
Bu nesne, ödeme sayfasına girilen bir fırsat kodu hakkında bilgi sağlar.
| Mülk | Tür | Gereklilik | Açıklama |
|---|---|---|---|
redemptionCodes |
dizi | Her zaman var | Ödeme sayfasına girilen promosyon kodları grubu. Daha önce onaylanmış kodları içerir. |
Örnek
Aşağıdaki örnekte, redemptionCodes dizisi içeren bir OfferData nesnesi gösterilmektedir.
"offerData": { "redemptionCodes": ["PROMOTIONALCODE"] }