Instrument de plată Google Pay

Această referință se bazează pe schema Instrumentului de plată cu cardul pentru obiectul instrumentului de plată returnat de gestionarul plăților Google Pay la finalizarea comenzii în cadrul matricei 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
  }
}

Proprietăți

Proprietate	Tip	Întotdeauna prezent?	Descriere
id	şir	Da	Un identificator unic pentru această instanță a instrumentului de plată, atribuit de platformă.
handler_id	şir	Da	Identificatorul unic pentru instanța handlerului care a produs acest instrument. Corespunde câmpului id din configurația handlerului de plăți.
type	şir	Da	Tipul instrumentului de plată, de exemplu card .
selected	boolean	Nu	Indică dacă acest instrument a fost selectat de utilizator.
display	obiect	Da	Afișează informații despre instrumentul de plată.
display. brand	şir	Da	Marca/rețeaua cardului (de exemplu, „VISA”).
display. last_digits	şir	Da	Ultimele 4 cifre ale numărului cardului.
display. description	şir	Nu	O descriere a cardului, orientată spre utilizator.
display. card_art	şir	Nu	Un URI către o imagine care reprezintă cardul.
billing_address	obiect	Nu	Adresa de facturare asociată cardului. Returnată numai dacă billing_address_required a fost setat la true în configurație.
billing_address. first_name	şir	Nu	Prenumele persoanei de contact asociate cu adresa.
billing_address. last_name	şir	Nu	Numele de familie al contactului asociat cu adresa.
billing_address. street_address	şir	Nu	Adresa stradală.
billing_address. extended_address	şir	Nu	O extensie de adresă (de exemplu, numărul apartamentului sau al suitei).
billing_address. address_locality	şir	Nu	Localitatea (de exemplu, orașul).
billing_address. address_region	şir	Nu	Regiunea (de exemplu, statul sau provincia).
billing_address. postal_code	şir	Nu	Codul poștal.
billing_address. address_country	şir	Nu	Codul țării (format ISO 3166-1 alpha-2, format din 2 litere).
billing_address. phone_number	şir	Nu	Numărul de telefon. Se returnează numai dacă phone_number_required a fost setat la true în configurație.
credential	obiect	Nu	Datele de tokenizare securizată returnate de Google Pay.
credential. type	şir	Da	Tipul de tokenizare. Se potrivește cu tipul configurat. PAYMENT_GATEWAY : Se utilizează dacă procesați plăți printr-un gateway acceptat . DIRECT : Se folosește dacă decriptați singur acreditările.
credential. token	şir	Da	Tokenul de acreditare de plată criptat ca șir serializat JSON. Pentru PAYMENT_GATEWAY , aceasta conține sarcina criptată care trebuie transmisă către gateway-ul dvs. Pentru DIRECT , aceasta conține detaliile criptate ale cardului (necesită decriptarea folosind cheia dvs. privată). Consultați ghidul de criptografie a datelor de plată pentru detalii despre format și procesul de decriptare.