Configuration du gestionnaire de paiements Google Pay

Cette documentation de référence est basée sur le schéma d'objet de configuration pour le gestionnaire de paiement Google Pay pour 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,
        "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 Obligatoire 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 d'identité du marchand.
merchant_info.merchant_id chaîne Obligatoire Votre ID de marchand Google Pay dans la Google Pay & Wallet Console. Ce paramètre est obligatoire pour l'environnement PRODUCTION. Il est facultatif et ignoré dans l'environnement TEST. Votre ID de marchand est une valeur numérique OU alphanumérique affichée à côté du nom de votre établissement dans la Google Pay &Wallet Console.
merchant_info.merchant_name chaîne Facultatif Nom de l'établissement visible par l'utilisateur.
merchant_info.merchant_origin chaîne Facultatif Nom de domaine Web complet où le paiement a lieu (format : hostname).
merchant_info.auth_jwt chaîne Facultatif JWT d'autorisation pour certains contextes d'intégration.
allowed_payment_methods objet[ ] Obligatoire Modes de paiement autorisés pour cette transaction.
allowed_payment_methods[].type chaîne Obligatoire Type de mode de paiement accepté. Valeurs acceptées : CARD, EWALLET.
allowed_payment_methods[].parameters objet Facultatif Paramètres requis pour configurer le mode de paiement CARD. Cette propriété est obligatoire si type est 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.billing_address_required booléen Facultatif Définissez la valeur sur true si vous avez besoin d'une adresse de facturation pour effectuer 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 effectuer la transaction.
  • MIN : nom, code pays et code postal (par défaut).
  • FULL : nom, adresse postale, ville, région, code pays et code postal.
  • FULL-ISO3166 : nom, adresse postale, ville, 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 effectuer la transaction.
allowed_payment_methods[].tokenization_specification objet Facultatif Configuration qui définit comment les identifiants de paiement vous sont renvoyés. Cette propriété est obligatoire si type est CARD.
allowed_payment_methods[].tokenization_specification.type chaîne Obligatoire Type de tokenisation.
  • PAYMENT_GATEWAY : utilisé si vous traitez les paiements via une [passerelle compatible](/pay/api#participating-processors). Renvoie une charge utile chiffrée à transmettre à votre PSP.
  • DIRECT : utilisé si vous déchiffrez vous-même les identifiants (nécessite la conformité au niveau 1 de la norme PCI DSS).
allowed_payment_methods[].tokenization_specification.parameters objet Obligatoire Paramètres spécifiques au type de tokenisation sélectionné.

Pour PAYMENT_GATEWAY, les paramètres obligatoires sont les suivants : Pour DIRECT, les paramètres obligatoires sont les suivants :
allowed_payment_methods[].processing_specification objet Facultatif Définissez les informations requises pour traiter le paiement. Cette propriété est obligatoire si type est EWALLET.
allowed_payment_methods[].processing_specification.type chaîne Obligatoire Type de fournisseur d'e-portefeuille. Valeurs acceptées : SHOPEE_PAY, TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters objet Obligatoire Paramètres spécifiques au fournisseur d'e-portefeuille sélectionné.

Les paramètres obligatoires sont les suivants :
  • ewallet_merchant_name : nom à afficher du marchand visible par l'utilisateur.
  • ewallet_merchant_account : identifiant du marchand émis par l'e-portefeuille ou l'agrégateur.
  • psp_transaction_reference : numéro de référence unique généré par le PSP pour l'idempotence.