Instrument płatniczy Google Pay

Ten dokument odwołuje się do schematu instrumentu płatniczego w postaci karty w przypadku obiektu instrumentu płatniczego zwracanego przez moduł obsługi płatności Google Pay po zakończeniu płatności w tablicy payment.instruments.

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

Właściwości

Właściwość	Typ	Zawsze obecna?	Opis
id	ciąg znaków	Tak	Unikalny identyfikator tej instancji instrumentu płatniczego przypisany przez platformę.
handler_id	ciąg znaków	Tak	Unikalny identyfikator instancji modułu obsługi, która utworzyła ten instrument. Odpowiada polu id w konfiguracji modułu obsługi płatności.
type	ciąg znaków	Tak	Typ instrumentu płatniczego, np. card.
selected	wartość logiczna	Nie	Wskazuje, czy ten instrument został wybrany przez użytkownika.
display	obiekt	Tak	Informacje o wyświetlaniu instrumentu płatniczego.
display.brand	ciąg znaków	Tak	Marka lub sieć karty (np. „VISA”).
display.last_digits	ciąg znaków	Tak	4 ostatnie cyfry numeru karty.
display.description	ciąg znaków	Nie	Opis karty przeznaczony dla użytkownika.
display.card_art	ciąg znaków	Nie	Identyfikator URI obrazu przedstawiającego kartę.
billing_address	obiekt	Nie	Adres rozliczeniowy powiązany z kartą. Zwracany tylko wtedy, gdy w konfiguracji ustawiono wartość true w polu billing_address_required.
billing_address.first_name	ciąg znaków	Nie	Imię osoby kontaktowej powiązanej z adresem.
billing_address.last_name	ciąg znaków	Nie	Nazwisko osoby kontaktowej powiązanej z adresem.
billing_address.street_address	ciąg znaków	Nie	Ulica i numer.
billing_address.extended_address	ciąg znaków	Nie	Rozszerzenie adresu (np. numer mieszkania lub lokalu).
billing_address.address_locality	ciąg znaków	Nie	Miejscowość (np. miasto).
billing_address.address_region	ciąg znaków	Nie	Region (np. stan lub województwo).
billing_address.postal_code	ciąg znaków	Nie	Kod pocztowy.
billing_address.address_country	ciąg znaków	Nie	Kod kraju (2-literowy format ISO 3166-1 alfa-2).
billing_address.phone_number	ciąg znaków	Nie	Numer telefonu. Zwracany tylko wtedy, gdy w konfiguracji ustawiono wartość true w polu phone_number_required.
credential	obiekt	Nie	Dane bezpiecznej tokenizacji zwracane przez Google Pay.
credential.type	ciąg znaków	Tak	Typ tokenizacji. Musi być zgodny ze skonfigurowanym typem. PAYMENT_GATEWAY: używany, jeśli płatności są przetwarzane przez obsługiwaną bramę. DIRECT: używany, jeśli samodzielnie odszyfrowujesz dane uwierzytelniające.
credential.token	ciąg znaków	Tak	Zaszyfrowany token danych uwierzytelniających płatność jako ciąg znaków w formacie JSON. W przypadku PAYMENT_GATEWAY zawiera zaszyfrowany ładunek do przekazania do bramy. W przypadku DIRECT zawiera zaszyfrowane dane karty (wymaga odszyfrowania za pomocą klucza prywatnego). Szczegółowe informacje o formacie i procesie odszyfrowywania znajdziesz w przewodniku Kryptografia danych płatności.