Configuration du gestionnaire de paiements Google Pay

Cette référence est basée sur le schéma de l'objet de configuration pour le gestionnaire de paiement Google Pay pour l'Universal Commerce Protocol (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

Propriétés

Propriété Type Nécessité Description
api_version entier Obligatoire Version majeure de l'API Google Pay. Seule l'option 2 est acceptée.
api_version_minor entier Obligatoire Version mineure de l'API Google Pay. Seule l'option 0 est acceptée.
environment chaîne Obligatoire Environnement Google Pay à utiliser.
  • TEST : identifiants de paiement réservés aux tests.
  • PRODUCTION : identifiants de paiement réels et autorisables.
merchant_info objet Obligatoire Informations sur l'identité du marchand.
merchant_info.merchant_id chaîne Obligatoire Votre ID de marchand Google Pay depuis la Google Pay & Wallet Console. Ce paramètre est obligatoire pour l'environnement PRODUCTION. Elle est facultative et ignorée dans l'environnement TEST.
merchant_info.merchant_name chaîne Facultatif Nom commercial du marchand visible par les utilisateurs.
merchant_info.merchant_origin chaîne Facultatif Nom de domaine Web complet où a lieu le règlement (format : hostname).
merchant_info.auth_jwt chaîne Facultatif Jeton JWT d'autorisation pour certains contextes d'intégration.
allowed_payment_methods object[ ] Obligatoire Modes de paiement autorisés pour cette transaction.
allowed_payment_methods[].type chaîne Obligatoire Type de mode de paiement accepté. Seule l'option CARD est acceptée.
allowed_payment_methods[].parameters objet Obligatoire Paramètres requis pour configurer le mode de paiement CARD.
allowed_payment_methods[].parameters.allowed_auth_methods chaîne[ ] Obligatoire Champs acceptés pour authentifier une transaction par carte.
  • PAN_ONLY : renvoie le numéro de compte principal (PAN) et la date d'expiration d'une carte enregistrée dans Google Wallet.
allowed_payment_methods[].parameters.allowed_card_networks chaîne[ ] Obligatoire Réseaux de cartes acceptés par le marchand. Valeurs acceptées : AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards booléen Facultatif Définissez la valeur sur false si vous n'acceptez pas les cartes prépayées. La valeur par défaut est true.
allowed_payment_methods[].parameters.allow_credit_cards booléen Facultatif Définissez la valeur sur false si vous n'acceptez pas les cartes de crédit. La valeur par défaut est true.
allowed_payment_methods[].parameters.assurance_details_required booléen Facultatif Définissez la valeur sur true pour demander les informations d'assurance de la carte.
allowed_payment_methods[].parameters.billing_address_required booléen Facultatif Définissez la valeur sur true si vous avez besoin d'une adresse de facturation pour finaliser la transaction.
allowed_payment_methods[].parameters.billing_address_parameters objet Facultatif Paramètres qui configurent l'adresse de facturation renvoyée.
allowed_payment_methods[].parameters.billing_address_parameters.format chaîne Facultatif Format de l'adresse de facturation requis pour finaliser la transaction.
  • MIN : nom, code pays et code postal (par défaut).
  • FULL : nom, adresse postale, localité, région, code pays et code postal.
  • FULL-ISO3166 : nom, adresse postale, localité, région, code pays, code postal et iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required booléen Facultatif Définissez la valeur sur true si vous avez besoin d'un numéro de téléphone pour finaliser la transaction.
allowed_payment_methods[].tokenization_specification objet Obligatoire Configuration qui définit la façon dont les identifiants de paiement vous sont renvoyés.
allowed_payment_methods[].tokenization_specification.type chaîne Obligatoire Type de tokenisation.
  • PAYMENT_GATEWAY : à utiliser si vous traitez les paiements via une [passerelle compatible](/pay/api#participating-processors). Renvoie une charge utile chiffrée à transmettre à votre PSP.
  • DIRECT : à utiliser si vous déchiffrez vous-même les identifiants (nécessite la conformité avec la norme PCI DSS de niveau 1).
allowed_payment_methods[].tokenization_specification.parameters objet Obligatoire Paramètres spécifiques à la tokenisation type sélectionnée.

Pour PAYMENT_GATEWAY, les paramètres obligatoires sont les suivants : Pour DIRECT, les paramètres obligatoires sont les suivants :