JSON yanıt nesneleri

Bu referansta, uygulamanızla 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.

PaymentData

Bu, ödeme yapan taraf ö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,
apiVersionMinor sayı Evet Küçük API sürümü. Yanıtın değeri,
paymentMethodData PaymentMethodData Evet Seçilen ödeme yöntemiyle ilgili veriler.
email dize Hayır emailRequired, PaymentDataRequest. Başka bir istekte özellik true olarak ayarlanmışsa herhangi bir etkisi olmaz.
shippingAddress Adres Hayır shippingAddressRequired,

Örnek

Google Pay API sürüm 2.0'a ait 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"
    }
  }
}

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.
cardNetwork dize Evet

Seçilen ödemenin ödeme kartı ağı. Döndürülen değerler, CardParameters.

Bu kart ağı değeri, alıcıya gösterilmemelidir. Alıcının kart bilgilerine ihtiyaç duyulduğunda 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 description özelliğini kullanın.
billingAddress Adres Hayır billingAddressRequired, CardParameters.
cardFundingSource dize Evet

Seçilen ödeme yöntemi için kart ödeme kaynağı.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Ö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 boolean true ise döndürülen ödeme kimlik bilgisinde Cardholder sahiplik doğrulamasının yapıldığını gösterir.
cardHolderAuthenticated boolean

true, döndürülen ödeme kimlik bilgisi üzerinde kimlik tanımlama ve doğrulama (ID&V) işleminin yapıldığını gösterir.

false ise kart işlemleri için yaptığınız gibi aynı risk tabanlı kimlik doğrulama işlemi gerçekleştirilebilir. Bu risk tabanlı kimlik doğrulama, geçerli olduğu durumlarda 3D Secure protokolüyle adım adım doğrulama gibi yöntemleri içerebilir ancak bunlarla sınırlı değildir.

assuranceDetails alanını kullanmasanız bile yanıt nesnesini alıp işleyebilirsiniz. Bu nesneyi almak için İstek nesnesinin assuranceDetailsRequired: true özelliğini CardParameters.

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.
token dize Hayır

Oluşturulan ödeme yöntemi jetonu.

  • PAYMENT_GATEWAY: Ağ geçidiniz tarafından verilen, ücretlendirilebilir bir jeton içeren JSON nesnesi dizesi.
  • DIRECT: protocolVersion, signature ve şifre çözme için signedMessage kullanılır. Daha fazla bilgi için Ödeme yöntemi jetonu yapısı bölümüne bakın.

Örnek

Bu, example ağ geçidi için hazırlanmış bir jetonlaştırılmış yanıt örneğidir.

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

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, FULL-ISO3166 Alıcının tam adı.
postalCode MIN, FULL, FULL-ISO3166 Posta kodu.
countryCode MIN, FULL, FULL-ISO3166 ISO 3166-1 alfa-2 ülke kodu.
phoneNumber MIN, FULL, FULL-ISO3166 PaymentDataRequest.
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 ile eşleşen ISO 3166-2 idari bölge kodu.

Örnek

Bu, Amerika Birleşik Devletleri'nde birden fazla satır açık adres verisi 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"
}