Obiekty odpowiedzi JSON

W tym artykule znajdziesz opis opcji związanych z obiektami odpowiedzi Google Pay API do wykorzystania w aplikacji. Obiekty odpowiedzi są obiektami zwracanymi przez metody klienta Google Pay API.

PaymentData

To jest obiekt odpowiedzi zwracany przez Google po tym, jak płatnik zatwierdzi płatność.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
Właściwość Typ Zawsze istnieje Opis
apiVersion Liczba Tak Główny numer wersji interfejsu API. Wartość w odpowiedzi jest zgodna z wartością w
apiVersionMinor liczba Tak Pomocniczy numer wersji interfejsu API. Wartość w odpowiedzi jest zgodna z wartością w
paymentMethodData PaymentMethodData Tak Informacje o wybranej formie płatności.
email Ciąg znaków Nie Adres e-mail, jeśli właściwość emailRequired jest ustawiona jako true w PaymentDataRequest.Jeśli inne żądanie ma właściwość ustawioną jako true, nic się nie dzieje.
shippingAddress Adres Nie Adres dostawy, jeśli właściwość shippingAddressRequired jest ustawiona jako true w

Przykład

Ta przykładowa odpowiedź wykorzystująca Google Pay API w wersji 2.0 wskazuje formę płatności CARD wybraną w arkuszu płatności Google Pay. Dla bramy example został wygenerowany token formy płatności.

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

PaymentMethodData

Ten obiekt dostarcza dane dla wybranej formy płatności.

Właściwość Typ Zawsze istnieje Opis
type Ciąg znaków Tak PaymentMethod type wybrany w arkuszu płatności Google Pay.
description ciąg tekstowy Tak

Wiadomość dla użytkownika, która opisuje formę płatności wybraną dla tej transakcji.
info Obiekt Tak Wartość tej właściwości zależy od zwróconej wartości type danej formy płatności. Informacje dotyczące CARD znajdziesz w opisie właściwości CardInfo.
tokenizationData PaymentMethodTokenizationData Nie Dane tokenizacji płatności, które są używane przez wybraną formę płatności.

Przykład

Ta przykładowa odpowiedź ilustruje, jak forma płatności CARD wybrana w arkuszu płatności Google Pay generuje token formy płatności dla bramy example.

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

CardInfo

Ten obiekt dostarcza informacji o wybranej karcie płatniczej.

Właściwość Typ Zawsze istnieje Opis
cardDetails Ciąg znaków Tak Informacje o karcie. Są to zwykle ostatnie 4 cyfry wybranego numeru konta płatności.
assuranceDetails AssuranceDetailsSpecifications Tak Ten obiekt dostarcza informacje o weryfikacji przeprowadzonej na zwróconych danych płatności, jeśli właściwość assuranceDetailsRequired została ustawiona jako true w CardParameters.
cardNetwork ciąg tekstowy Tak

Sieć karty płatniczej wybranej płatności. Zwracane wartości mają format jak allowedCardNetworks w CardParameters.

Ta wartość sieci karty nie powinna wyświetlać się u kupującego. Jest używana, gdy są potrzebne informacje o jego karcie. Przykładem może być sytuacja, w której pracownik obsługi klienta potrzebuje tej wartości, aby zidentyfikować kartę użytą przez kupującego do transakcji. Aby wyświetlić opis widoczny dla użytkowników, użyj właściwości description z PaymentMethodData.
billingAddress Adres Nie Adres rozliczeniowy powiązany z podaną formą płatności, jeżeli właściwość billingAddressRequired została ustawiona jako true w CardParameters.
cardFundingSource ciąg tekstowy Tak

Źródło finansowania karty dla wybranej formy płatności.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Przykład

Ten przykład dotyczy karty w sieci Visa.

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

AssuranceDetailsSpecifications

Ten obiekt dostarcza informacji o tym, jaka weryfikacja została przeprowadzona na zwróconych danych uwierzytelniających płatność, aby można było zastosować odpowiednie kontrole ryzyka instrumentu.

Imię i nazwisko Typ Opis
accountVerified Wartość logiczna Jeśli true, oznacza to, że na zwróconych danych uwierzytelniających płatności przeprowadzona została weryfikacja posiadania Cardholder.
cardHolderAuthenticated Wartość logiczna

Jeśli true, oznacza to, że na zwróconych danych uwierzytelniających płatności przeprowadzona została identyfikacja i weryfikacja.

Jeśli false, można przeprowadzić to samo uwierzytelnianie oparte na ryzyku, co w przypadku transakcji kartą. Uwierzytelnianie oparte na ryzyku może obejmować m.in. uwierzytelnianie stopniowe z protokołem 3D Secure, jeśli ma to zastosowanie.

Możesz otrzymywać i przetwarzać obiekt odpowiedzi, nawet jeśli nie używasz pola assuranceDetails. Aby otrzymać ten obiekt, w obiekcie żądania uwzględnij assuranceDetailsRequired: true w  CardParameters.

PaymentMethodTokenizationData

Ten obiekt dostarcza dane tokenizacji formy płatności.

Właściwość Typ Zawsze istnieje Opis
type Ciąg znaków Tak Typ tokenizacji, który ma zostać użyty z wybraną formą płatności. Ta wartość jest zgodna z wartością type w PaymentMethodTokenizationSpecification
token ciąg tekstowy Nie

Wygenerowany token formy płatności.

  • PAYMENT_GATEWAY: ciąg znaków obiektu JSON, który zawiera możliwy do obciążenia token wydany przez Twoją bramę.
  • DIRECT: protocolVersion, signature oraz signedMessage potrzebne do odszyfrowania. Więcej informacji znajdziesz w sekcji o strukturze tokena formy płatności .

Przykład

Oto przykład tokenizowanej odpowiedzi przygotowanej dla bramy example.

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

Adres

Ten obiekt dostarcza informacji o wymaganym adresie pocztowym. Wszystkie właściwości mają formę ciągu znaków.

Adresy mogą być zwracane w formatach MIN, FULL i FULL-ISO3166. Właściwości należące do poszczególnych formatów znajdziesz w tej tabeli.

Właściwość Format adresu Opis
name MIN, FULL, FULL-ISO3166 Imię i nazwisko adresata.
postalCode MIN, FULL, FULL-ISO3166 Kod pocztowy.
countryCode MIN, FULL, FULL-ISO3166 Kod kraju zgodny ze standardem ISO 3166-1 alpha-2.
phoneNumber MIN, FULL, FULL-ISO3166 Numer telefonu, jeśli właściwość phoneNumberRequired została ustawiona jako true w PaymentDataRequest.
address1 FULL, FULL-ISO3166 Pierwszy wiersz adresu.
address2 FULL, FULL-ISO3166 Drugi wiersz adresu.
address3 FULL, FULL-ISO3166 Trzeci wiersz adresu.
locality FULL, FULL-ISO3166 Miasto, dzielnica lub przedmieście.
administrativeArea FULL, FULL-ISO3166 Jednostka administracyjna w danym kraju, np. stan lub prowincja.
sortingCode FULL, FULL-ISO3166 Kod banku.
iso3166AdministrativeArea FULL-ISO3166 Kod regionu administracyjnego zgodny ze standardem ISO 3166-2 odpowiadający wartości administrativeArea.

Przykład

Oto przykładowy adres w Stanach Zjednoczonych w formacie FULL-ISO3166 z danymi o ulicy i numerze umieszczonymi w kilku wierszach.

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