Strumento di pagamento Google Pay

Questo riferimento si basa sullo schema dello strumento di pagamento con carta per l'oggetto dello strumento di pagamento restituito dal gestore dei pagamenti Google Pay al completamento del pagamento all'interno dell'array 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à

Proprietà	Tipo	Sempre presente?	Descrizione
id	stringa	Sì	Un identificatore univoco per questa istanza dello strumento di pagamento, assegnato dalla piattaforma.
handler_id	stringa	Sì	L'identificatore univoco dell'istanza del gestore che ha prodotto questo strumento. Corrisponde al campo id nella configurazione del gestore dei pagamenti.
type	stringa	Sì	Il tipo di strumento di pagamento, ad es. card.
selected	booleano	No	Indica se questo strumento è stato selezionato dall'utente.
display	oggetto	Sì	Visualizza i dati dello strumento di pagamento.
display.brand	stringa	Sì	Il brand/la rete della carta (ad esempio, "VISA").
display.last_digits	stringa	Sì	Ultime 4 cifre del numero di carta.
display.description	stringa	No	Una descrizione della scheda rivolta all'utente.
display.card_art	stringa	No	Un URI a un'immagine che rappresenta la scheda.
billing_address	oggetto	No	L'indirizzo di fatturazione associato alla carta. Restituito solo se billing_address_required è stato impostato su true nella configurazione.
billing_address.first_name	stringa	No	Il nome del contatto associato all'indirizzo.
billing_address.last_name	stringa	No	Il cognome del contatto associato all'indirizzo.
billing_address.street_address	stringa	No	La via.
billing_address.extended_address	stringa	No	Un'estensione dell'indirizzo (ad esempio, il numero dell'appartamento o della suite).
billing_address.address_locality	stringa	No	La località (ad esempio la città).
billing_address.address_region	stringa	No	La regione (ad esempio, stato o provincia).
billing_address.postal_code	stringa	No	Il codice postale.
billing_address.address_country	stringa	No	Il codice paese (formato ISO 3166-1 alpha-2 a 2 lettere).
billing_address.phone_number	stringa	No	Il numero di telefono. Restituito solo se phone_number_required è stato impostato su true nella configurazione.
credential	oggetto	No	I dati di tokenizzazione sicuri restituiti da Google Pay.
credential.type	stringa	Sì	Il tipo di tokenizzazione. Corrisponde al tipo configurato. PAYMENT_GATEWAY: utilizzato se elabori i pagamenti tramite un gateway supportato. DIRECT: utilizzato se decripti le credenziali personalmente.
credential.token	stringa	Sì	Il token delle credenziali di pagamento criptate come stringa serializzata JSON. Per PAYMENT_GATEWAY, questo contiene il payload criptato da passare al gateway. Per DIRECT, contiene i dati della carta criptati (richiede la decrittografia utilizzando la chiave privata). Per informazioni dettagliate sul formato e sulla procedura di decrittografia, consulta la guida Crittografia dei dati di pagamento.