Obiecte de răspuns JSON

Această referință descrie opțiunile obiectului de răspuns Google Pay API pe care le puteți utiliza cu aplicația dvs. Obiectele de răspuns sunt obiecte returnate de metodele clientului Google Pay API.

Date de plată

Acesta este un obiect de răspuns returnat de Google după ce un plătitor aprobă plata.

Proprietate Tip Există întotdeauna Descriere
apiVersion număr Da Versiune API majoră. Valoarea din răspuns corespunde cu valoarea furnizată în PaymentDataRequest .
apiVersionMinor număr Da Versiune API minoră. Valoarea din răspuns corespunde cu valoarea furnizată în PaymentDataRequest .
paymentMethodData Date despre metoda de plată Da Date despre metoda de plată selectată.
email şir Nu Adresă de e-mail, dacă emailRequired este setată la true în CerereDatePlăți .Dacă o altă cerere are proprietatea setată la true , nu are niciun efect.
shippingAddress Adresa Nu Adresa de livrare, dacă shippingAddressRequired este setată la true în CerereDatePlăți .

Exemplu

Acest exemplu de răspuns pentru Google Pay API versiunea 2.0 prezintă o metodă de plată CARD selectată în foaia de plată Google Pay. Un token al metodei de plată a fost generat pentru gateway-ul example .

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

Date despre metoda de plată

Acest obiect furnizează date pentru o metodă de plată selectată.

Proprietate Tip Există întotdeauna Descriere
type şir Da PaymentMethod type selectat în foaia de plată Google Pay.
description şir Da

Mesaj orientat către utilizator care descrie metoda de plată ce finanțează această tranzacție.

info obiect Da Valoarea acestei proprietăți depinde de type metodei de plată returnate. Pentru CARD , consultați CardInfo .
tokenizationData Metodă de platăTokenizareDate Nu Date de tokenizare a plății pentru metoda de plată selectată.

Exemplu

Acest exemplu de răspuns arată cum o metodă de plată CARD selectată în foaia de plată Google Pay generează un token de metodă de plată pentru gateway- example .

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

Informații card

Acest obiect oferă informații despre cardul de plată selectat.

Proprietate Tip Există întotdeauna Descriere
cardDetails şir Da Detaliile despre card. Această valoare este de obicei reprezentată de ultimele patru cifre ale numărului contului de plată selectat.
assuranceDetails Detalii privind asigurareaSpecificații Da Acest obiect oferă informații despre validarea efectuată asupra datelor de plată returnate dacă assuranceDetailsRequired este setat la true în ParametriCard .
cardNetwork şir Da

Rețeaua de carduri de plată pentru plata selectată. Valorile returnate corespund formatului allowedCardNetworks din ParametriCard .

Această valoare a rețelei de carduri nu ar trebui afișată cumpărătorului. Este utilizată atunci când sunt necesare detaliile cardului unui cumpărător. De exemplu, dacă serviciul de asistență pentru clienți are nevoie de această valoare pentru a identifica cardul pe care un cumpărător l-a folosit pentru tranzacția sa. Pentru o descriere vizibilă utilizatorului, utilizați proprietatea description a PaymentMethodData .

billingAddress Adresa Nu Adresa de facturare asociată metodei de plată furnizate, dacă billingAddressRequired este setat la true în ParametriCard .
cardFundingSource şir Da

Sursa de alimentare a cardului pentru metoda de plată selectată.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Exemplu

Acest exemplu prezintă un card din rețeaua Visa.

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

Detalii privind asigurareaSpecificații

Acest obiect oferă informații despre validarea efectuată asupra acreditărilor de plată returnate, astfel încât să se poată aplica verificările adecvate ale riscului instrumentului.

Nume Tip Descriere
accountVerified boolean Dacă true , indică faptul că validarea posesiei Cardholder a fost efectuată pe acreditările de plată returnate.
cardHolderAuthenticated boolean

Dacă true , indică faptul că s-au efectuat identificări și verificări (ID&V) asupra acreditării de plată returnate.

Dacă este false , se poate efectua aceeași autentificare bazată pe risc ca și în cazul tranzacțiilor cu cardul. Această autentificare bazată pe risc poate include, dar fără a se limita la, trecerea la protocolul 3D Secure, dacă este cazul.

Puteți primi și procesa răspunsul Object chiar dacă nu utilizați câmpul assuranceDetails . Pentru a primi acest obiect, includeți assuranceDetailsRequired: true în câmpul Request al obiectului. ParametriCard .

Metodă de platăTokenizareDate

Acest obiect furnizează date de tokenizare pentru metoda de plată.

Proprietate Tip Există întotdeauna Descriere
type şir Da Tipul de tokenizare care va fi aplicat metodei de plată selectate. Această valoare corespunde type setat în PaymentMethodTokenizationSpecification .
token şir Nu

Tokenul metodei de plată generat.

Exemplu

Acesta este un exemplu de răspuns tokenizat pregătit pentru gateway-ul example .

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

Adresa

Acest obiect oferă informații despre o adresă poștală solicitată. Toate proprietățile sunt șiruri de caractere.

Adresele pot fi returnate în formatele MIN , FULL și FULL-ISO3166 . Proprietățile aparținând fiecărui format pot fi văzute în tabelul următor.

Proprietate Formatul adresei Descriere
name MIN , FULL , FULL-ISO3166 Numele complet al destinatarului.
postalCode MIN , FULL , FULL-ISO3166 Codul poștal sau ZIP.
countryCode MIN , FULL , FULL-ISO3166 Codul țării ISO 3166-1 alpha-2.
phoneNumber MIN , FULL , FULL-ISO3166 Un număr de telefon, dacă phoneNumberRequired este setat la true în CerereDatePlăți .
address1 FULL , FULL-ISO3166 Prima linie a adresei.
address2 FULL , FULL-ISO3166 A doua linie a adresei.
address3 FULL , FULL-ISO3166 A treia linie a adresei.
locality FULL , FULL-ISO3166 Oraș, sat, cartier sau suburbie.
administrativeArea FULL , FULL-ISO3166 O subdiviziune a unei țări, cum ar fi un stat sau o provincie.
sortingCode FULL , FULL-ISO3166 Codul de sortare.
iso3166AdministrativeArea FULL-ISO3166 Codul de zonă administrativă ISO 3166-2 corespunzător zonei administrative.

Exemplu

Acesta este un exemplu de adresă în format FULL-ISO3166 din Statele Unite, cu mai multe rânduri de date despre adresa stradală.

{
  "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"
}