Mode de paiement Google Pay

Cette référence est basée sur le schéma de l'instrument de paiement par carte pour l'objet d'instrument de paiement renvoyé par le gestionnaire de paiement Google Pay à la fin du règlement dans le tableau 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
  }
}

Propriétés

Propriété	Type	Toujours présent ?	Description
id	chaîne	Oui	Identifiant unique de cette instance de mode de paiement, attribué par la plate-forme.
handler_id	chaîne	Oui	Identifiant unique de l'instance de gestionnaire qui a produit cet instrument. Correspond au champ id de la configuration du gestionnaire de paiement.
type	chaîne	Oui	Type d'instrument de paiement, par exemple card.
selected	booléen	Non	Indique si cet instrument a été sélectionné par l'utilisateur.
display	objet	Oui	Affichez les informations du mode de paiement.
display.brand	chaîne	Oui	Marque/réseau de la carte (par exemple, "VISA").
display.last_digits	chaîne	Oui	Quatre derniers chiffres du numéro de carte.
display.description	chaîne	Non	Description de la carte visible par l'utilisateur.
display.card_art	chaîne	Non	URI d'une image représentant la carte.
billing_address	objet	Non	Adresse de facturation associée à la carte. N'est renvoyé que si billing_address_required a été défini sur true dans la configuration.
billing_address.first_name	chaîne	Non	Prénom du contact associé à l'adresse.
billing_address.last_name	chaîne	Non	Nom de famille du contact associé à l'adresse.
billing_address.street_address	chaîne	Non	Adresse postale.
billing_address.extended_address	chaîne	Non	Extension d'adresse (par exemple, numéro d'appartement ou de suite).
billing_address.address_locality	chaîne	Non	Localité (ville, par exemple).
billing_address.address_region	chaîne	Non	Région (État ou province, par exemple).
billing_address.postal_code	chaîne	Non	Code postal.
billing_address.address_country	chaîne	Non	Code pays (format ISO 3166-1 alpha-2 à deux lettres).
billing_address.phone_number	chaîne	Non	Numéro de téléphone. N'est renvoyé que si phone_number_required a été défini sur true dans la configuration.
credential	objet	Non	Données de tokenisation sécurisées renvoyées par Google Pay.
credential.type	chaîne	Oui	Type de tokenisation. Correspond au type configuré. PAYMENT_GATEWAY : à utiliser si vous traitez les paiements via une passerelle compatible. DIRECT : à utiliser si vous déchiffrez vous-même les identifiants.
credential.token	chaîne	Oui	Jeton d'identifiant de paiement chiffré sous forme de chaîne sérialisée au format JSON. Pour PAYMENT_GATEWAY, cela contient la charge utile chiffrée à transmettre à votre passerelle. Pour DIRECT, il contient les informations relatives à la carte chiffrées (nécessite un déchiffrement à l'aide de votre clé privée). Pour en savoir plus sur le format et le processus de déchiffrement, consultez le guide Cryptographie des données de paiement.