Google Pay

Pays & devises

Pays pris en charge

• Albanie
• Algérie
• Samoa américaines
• Angola
• Antigua-et-Barbuda
• Argentine
• Australie
• Autriche
• Azerbaïdjan
• Bahreïn
• Biélorussie
• Belgique
• Brésil
• Bulgarie
• Canada
• Chili
• Colombie
• Croatie
• République tchèque
• Danemark
• République dominicaine
• Égypte
• Estonie
• Finlande
• France
• Allemagne
• Grèce
• Hong Kong
• Hongrie
• Inde
• Indonésie
• Irlande
• Israël
• Italie
• Japon
• Jordanie
• Kazakhstan
• Kenya
• Koweït
• Liban
• Lituanie
• Luxembourg
• Malaisie
• Mexique
• Pays-Bas
• Nouvelle-Zélande
• Norvège
• Oman
• Pakistan
• Panama
• Pérou
• Philippines
• Pologne
• Portugal
• Qatar
• Roumanie
• Russie
• Arabie Saoudite
• Singapour
• Slovaquie
• Afrique du Sud
• Espagne
• Sri Lanka
• Suède
• Suisse
• Taïwan
• Thaïlande
• Turquie
• Ukraine
• Émirats Arabes Unis
• Royaume-Uni
• Îles mineures éloignées des États-Unis
• États-Unis
• Uruguay
• Vietnam

Devises prises en charge

Intégration

Avec Google Pay™, vos clients peuvent acheter des biens/services avec une carte de crédit ou de débit stockée dans leur compte Google. Que ce soit depuis leurs appareils Android ou sur Internet, le processus de paiement est beaucoup plus simple : Google Pay™ affiche une feuille de paiement qui sélectionne la méthode de paiement par carte préférée que les acheteurs confirment.
Regardez la vidéo pour voir comment les acheteurs paient avec Google Pay™.

Pour bénéficier d'un transfert de responsabilité lors de l'utilisation de Google Pay™, vous devez authentifier la transaction avec 3-D Secure.
Notre plateforme vous propose deux types d'intégration pour votre entreprise :

• Google Pay™ sur votre propre page de paiement
• Google Pay™ dans l'application

Retrouvez un aperçu général dans le chapitre "Cinématique".

Google Pay™ sur votre propre page de paiement

Utilisez notre SDK JavaScript pour intégrer Google Pay™ avec le bouton Google Pay™ directement dans votre propre page de paiement. Dans ce cas, vous devez ouvrir une page Google Pay™ et obtenir le token de paiement que Google chiffrera pour vous avec notre clé publique.
Une fois que vous avez reçu le token de paiement, vous devez nous l'envoyer en utilisant notre appel d'API Create Payment via l'API Serveur pour compléter le paiement. Après cette étape, nous nous occuperons du déchiffrement pour vous.
Pour ce faire, vous devez :

• Ouvrir une page Google Pay™.
• Obtenir le token de paiement que Google chiffre pour vous avec notre clé publique en utilisant l'API de Google.
• Envoyer le token de paiement en utilisant notre API CreatePayment avec l'un de nos SDK Serveur afin que nous puissions gérer le déchiffrement pour vous.

Ce mode d'intégration vous offre les avantages suivants :

• Meilleure visibilité du bouton Google Pay™ sur votre site web pour une conversion plus élevée.
• Vous pouvez utiliser l'API Google Pay™ pour récupérer les détails personnels de vos clients tels que leur adresse ou leur e-mail.

Une fois que vous avez suivi les directives de configuration de Google, vous êtes prêt pour l'intégration technique. Google propose un tutoriel clair et concis sur la manière d'implémenter Google Pay™ sur votre site web. L'intégration technique inclut les étapes suivantes :

1. Récupérer GooglePay™
2. Obtenir les réseaux de cartes de crédit disponibles
3. Se conformer à l'Authentification Forte du Client (SCA)
4. Afficher le bouton Google Pay™
5. Initialiser la feuille de paiement
6. Obtenir le token de paiement
7. Envoyer le token de paiement

1. Récupérer Google Pay™

Utilisez le JavaScript Client SDK pour récupérer le moyen de paiement Google Pay™ via l'appel API des moyens de paiement. Cela vous fournira les données nécessaires pour les étapes suivantes, telles que les réseaux pris en charge. Lors de la réception des informations sur le moyen de paiement, le SDK appellera également l'API Google isReadyToPay pour vérifier si Google Pay™ est disponible sur l'appareil et les paramètres que vos consommateurs utilisent. Si l'appel génère une erreur, le SDK ne retournera pas Google Pay™ comme méthode de paiement utilisable pour la transaction.

Utilisez l'exemple de code suivant pour effectuer l'appel :

// la session est une instance de l'objet Session, qui est le point d'entrée principal pour le SDK
session.getPaymentProduct(320, paymentDetails, paymentProductSpecificInputs).then(
    function(paymentProduct) {
        // Google Pay™ est disponible, montrez le bouton Google Pay™
     
        // Stockez le moyen de paiement dans la requête de paiement Connect
        session.getPaymentProductRequest().setPaymentProduct(paymentProduct);
    },
    function() {
        // Google Pay™ n'est pas disponible, offrez à votre client une autre option de paiement pour compléter le paiement
    }
);

2. Obtenez les réseaux de cartes de crédit disponibles

Vous devez spécifier le réseau de cartes de crédit autorisé pour la transaction Google Pay™ actuelle. L'appel GetPaymentProduct (à la fois via client-serveur et serveur-serveur) renvoie les réseaux disponibles. Les réseaux sont disponibles dans le champ de réponse paymentProduct320SpecificData. L'API Google Pay™ accepte directement les valeurs de retour.

Étant donné que nous décryptons pour vous le token de paiement Google Pay™, vous devez définir une valeur spécifique pour le champ ‘gateway’ dans la tokenizationSpecification. Cette valeur est également disponible dans le paymentProduct320SpecificData. Le gatewayMerchantId est votre propre merchantID (PSPID) sur notre plateforme.

• merchantID : le merchantID que vous obtenez de Google après inscription sur la Google Pay™ Business Console.
• merchantName : le nom affiché dans la feuille de paiement. Ceci est obligatoire si vous êtes basé dans l'Espace économique européen (EEE) pour répondre aux exigences de l'authentification forte du client (SCA). Encodez le merchantName en UTF-8 selon les spécifications de Google.
• gateway : utilisez la valeur renvoyée dans la réponse du produit : paymentProduct.paymentProduct320SpecificData.gateway.
• gatewayMerchantId : votre merchantID (PSPID) sur notre plateforme.

Utilisez le code suivant pour initialiser à la fois allowedCardNetworks et la tokenizationSpecification après avoir reçu le moyen de paiement Google Pay™ :

Initialiser Google Pay™

// Si vous souhaitez utiliser Google Pay™ dans votre application, vous devez vous inscrire
// auprès de Google pour recevoir un Google Merchant ID
var paymentProductSpecificInputs = {
  googlePay: {
    merchantId: '
  
   ',
    merchantName: '
   
    ',
    gatewayMerchantId: '
    
     '
  }
};
// Récupérer le moyen de paiement Google Pay™ via l'API client à serveur
// On suppose que les objets session, paymentDetails et paymentProductSpecificInputs ici sont tous valides
session.getPaymentProduct(320, paymentDetails, paymentProductSpecificInputs).then(
    function(paymentProduct) {
    
        const allowedCardNetworks = paymentProduct.paymentProduct320SpecificData.networks;
        const tokenizationSpecification = {
            type: 'PAYMENT_GATEWAY',
            parameters: {
                gateway: paymentProduct.paymentProduct320SpecificData.gateway,
                gatewayMerchantId: paymentProductSpecificInputs.googlePay.gatewayMerchantId
            }
        };
    
        // Stockez le moyen de paiement dans la requête de paiement, ce qui est requis pour
        // créer les données client encryptées plus tard
        session.getPaymentRequest().setPaymentProduct(paymentProduct);
    },
    function() {
        // Google Pay™ n'est pas disponible, offrez à votre client une autre option de paiement pour compléter le paiement
    }    
);

3. Se conformer à l'authentification forte du client (SCA)

Si votre acquéreur est situé dans l'Espace économique européen (EEE), vous devez soumettre les informations du pays/région de la banque acquéreuse à Google dans TransactionInfo.countryCode. Cela garantira votre conformité aux exigences de SCA. Google Pay™ renverra les données de transaction correspondantes en fonction du pays/région de votre acquéreur.
L'appel API du moyen de paiement depuis le Client SDK ou le Server-to-server renvoie le acquirerCountry que vous devez envoyer à Google. Le code suivant montre comment

• obtenir le code du pays de l'acquéreur à partir de la réponse du moyen de paiement et l'utiliser pour initialiser Google Pay™.
• obtenir le champ résultat de l'objet transactionInfo.
• spécifier les paramètres totalPrice et MerchantName (comme décrit dans l'étape 8.3 du tutoriel Google Pay™ et dans la section Authentification forte du client sur le site de documentation de Google).

Trouver plus d'informations sur la conformité à l'authentification forte du client pour Google Pay™ dans la documentation de l'API Google Pay™ et dans notre guide dédié.

Conformité à l'authentification forte du client (SCA)

// Si vous souhaitez utiliser Google Pay™ dans votre application, vous devez vous inscrire
// auprès de Google pour recevoir un Google Merchant ID
var paymentProductSpecificInputs = {
   googlePay: {
    merchantId: '
  
   ',
    merchantName: '
   
    ',
    gatewayMerchantId: '
    
     '
   }
};
// https://developers.google.com/pay/api/web/reference/request-objects#TransactionInfo
var transactionInfo = {
    currencyCode: 'currency code=""',
    totalPriceStatus: 'final',
    totalPrice: 'amount'
};

// Récupérer le moyen de paiement Google Pay™ via l'API client à serveur
// On suppose que les objets session, paymentDetails et paymentProductSpecificInputs ici sont tous valides
session.getPaymentProduct(320, paymentDetails, paymentProductSpecificInputs).then(
    function(paymentProduct) {
    
        const acquirerCountry = paymentProduct.acquirerCountry;
        if (acquirerCountry != null) {
            transactionInfo.countryCode = acquirerCountry;
        }
    },
    function() {
        // Google Pay™ n'est pas disponible, offrez à votre client une autre option de paiement pour compléter le paiement
    }
);

4. Rendre le bouton Google Pay™

Si Google Pay™ est disponible, ajoutez le bouton Google Pay™ sur votre page de paiement. Assurez-vous de suivre les directives de Google concernant l'affichage du bouton Google Pay™ et la politique de marque de Google.

Utilisez l'exemple de code suivant pour l'ajouter :

Ajouter le bouton Google Pay™

function addGooglePayButton() {
    const paymentsClient = getGooglePaymentsClient();
    const button =
        paymentsClient.createButton({
            onClick: onGooglePaymentButtonClicked
        });
    document.getElementById('container').appendChild(button);
}

5. Initialiser la feuille de paiement

Répondez au client en utilisant le bouton Google Pay™ en créant une session de paiement Google Pay™ pour le paiement :

Afficher la feuille de paiement Google Pay™

function onGooglePaymentButtonClicked() {
    const paymentDataRequest = getGooglePaymentDataRequest();
    paymentDataRequest.transactionInfo = getGoogleTransactionInfo();
    
    const paymentsClient = getGooglePaymentsClient();
    paymentsClient.loadPaymentData(paymentDataRequest).then(function(paymentData) {
        // gérer la réponse
        processPayment(paymentData);
    }).catch(function(err) {
        // afficher l'erreur dans la console du développeur pour débogage
        console.error(err);
    });
}

6. Obtenir le token de paiement

Pour traiter le paiement réel, vous devez demander le token de paiement à Google. Pour ce faire, utilisez l'exemple de code suivant :

    Obtenir le token de paiement Google Pay™

function processPayment(paymentData) {
    var paymentToken = paymentData.paymentMethodData.tokenizationData.token;
    @todo traiter le paymentToken comme décrit à l'étape suivante
}

7. Envoyer le token de paiement

Dans l'appel API de création de paiement, vous pouvez fournir des tokens de paiement de deux manières différentes :

1. Envoyez le token dans la propriété mobilePaymentMethodSpecificInput.encryptedPaymentData. Assurez-vous également d'envoyer mobilePaymentMethodSpecificInput.paymentProductId
   

   
   {
      "mobilePaymentMethodSpecificInput":{
         "encryptedPaymentData":"{\"signature\":\"MEUCIQCcSASjWu3ax9jQ8qX/+rsNLZ95uiyxamXiKnHlJi8A1QIgZj ...",
         "paymentProductId":"320"
      }
   }
   

2. Spécifiez le token comme valeur de paiement dans encryptedCustomerInput. Cette entrée est une liste chiffrée de paires clé-valeur, contenant généralement des données saisies par l'utilisateur, qui est compilée en fonction du champ de saisie réel. Les détails de paiement chiffrés du client :
   • sont à nouveau chiffrés
   • envoyés à votre serveur
   • enfin à notre serveur
     
     Vous devez utiliser le SDK Android côté client pour créer la valeur CustomerInput chiffrée. L'fieldId du champ de données de paiement chiffrées est renvoyé lorsque Google Pay™ reçoit des moyens de paiement via l'API. Bien que ce champ soit renvoyé comme un champ de saisie, vous ne devez pas fournir ce champ aux utilisateurs.

     
     // Cet exemple suppose que le SDK est correctement initialisé
     var paymentRequest = session.getPaymentRequest();
     paymentRequest.setValue("encryptedPaymentData", "{\"signature\":\"MEUCIG/WtsJnBf6yLsvnD2LOGaVMCO8E93QizIE0foMscVujAi...\"}")
     
     var encryptor = session.getEncryptor();
     
     encryptor.encrypt(paymentRequest).then(function(encryptedString) {
         // Envoyez le encryptedString à votre backend. Cette chaîne exacte est la valeur attendue pour le
         // encryptedCustomerInput dans Server-to-server CreatePaymentAPI
     }, function(errors) {
         // Informez le consommateur qu'un problème s'est produit
     });
     

Une fois que vous avez reçu le token, envoyez la requête de paiement à notre plateforme. Ajoutez les propriétés suivantes à une requête CreatePayment standard :

Propriétés	Remarques
mobilePaymentMethodSpecificInput      paymentProductId      requiresApproval      encryptedPaymentData	paymentProductId : Indique à notre plateforme de cibler Google Pay. requiresApproval : Traite la transaction comme une autorisation ou une Direct Sale. encryptedPaymentData : Le token que vous avez reçu à l'étape précédente.

Trouvez des informations détaillées sur cet objet et ses propriétés dans notre API CreatePayment.

Une requête typique ressemble à ceci :

    Request with 3-D Secure properties using encryptedPaymentData

{
  "mobilePaymentMethodSpecificInput": {
    "paymentProductId": "320",
    "requiresApproval": true,
    "encryptedPaymentData": "{\"signature\":\"MEUCIG/WtsJnBf6yLsvnD2LOGaVMCO8E93QizIE0foMscVujAi..."
  },
    "paymentProduct320SpecificInput": {
        "threeDSecure": {
          "challengeIndicator": "no-preference",
          "challengeCanvasSize": "600x400",
          "skipAuthentication": false,
          "redirectionData": {
            "returnUrl": "https://hostname.myownwebsite.url",
            "variant": "100"
        }
    }
  },
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 2300
    },
    "customer": {
      "billingAddress": {
        "countryCode": "BE"
      },
      "device": {
        "acceptHeader": "texthtml,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
        "browserData": {
          "colorDepth": 24,
          "javaEnabled": false,
          "screenHeight": "1200",
          "screenWidth": "1920"
        },
        "ipAddress": "123.123.123.123",
        "locale": "en-US",
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1 Safari/605.1.15",
        "timezoneOffsetUtcMinutes": "420"
      },
      "locale": "en_US",
      "merchantCustomerId": "your id="" of="" the="" consumer="""
    }
  }
}
    

    Request with 3-D Secure properties using encryptedCustomerInput

{
  "mobilePaymentMethodSpecificInput": {
    "paymentProductId": "320",
    "requiresApproval": true
  },
    "paymentProduct320SpecificInput": {
        "threeDSecure": {
          "challengeIndicator": "no-preference",
          "challengeCanvasSize": "600x400",
          "skipAuthentication": false,
          "redirectionData": {
            "returnUrl": "https://hostname.myownwebsite.url",
            "variant": "100"
        }
    }
  },
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 2300
    },
    "customer": {
      "billingAddress": {
        "countryCode": "BE"
      },
      "device": {
        "acceptHeader": "texthtml,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
        "browserData": {
          "colorDepth": 24,
          "javaEnabled": false,
          "javaScriptEnabled": true,
          "screenHeight": "800",
          "screenWidth": "360"
        },
        "ipAddress": "123.123.123.123",
        "locale": "en-US",
        "userAgent": "Mozilla/5.0 (Linux; Android 10; SM-G980F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.101 Mobile Safari/537.36",
        "timezoneOffsetUtcMinutes": "420"
      },
      "locale": "en_US",
      "merchantCustomerId": "your id="" of="" the="" consumer="""
    },
    "encryptedCustomerInput" : "encrypted string=""" 
  }
}

    Request without 3-D Secure properties using encryptedpaymentdata
    
    {
    "order" : {
        "amountOfMoney" : {
            "currencyCode" : "EUR",
            "amount" : 2300
        },
        "customer" : {
           "merchantCustomerId": "
  
   ",
           "billingAddress" : { 
                "countryCode" : "NL"
            }
        }
    },
    "mobilePaymentMethodSpecificInput" : { 
        "paymentProductId" : 320, 
        "encryptedPaymentData": "{\"signature\":\"MEUCIQCcSASjWu3ax9jQ8qX/+rsNLZ95uiyxamXiKnHlJi8A1QIgZj ..."
    } 
}

  

    Request without 3-D Secure properties using encryptedcustomerinput

    
    {
    "order" : {
        "amountOfMoney" : {
            "currencyCode" : "EUR",
            "amount" : 2300
        },
        "customer" : {
           "merchantCustomerId": "your id="" of="" the="" consumer=""",
           "billingAddress" : { 
                "countryCode" : "NL"
            }
        }
    },
    "encryptedCustomerInput" : "encrypted string=""" 
}

Google Pay™ dans l'application

Nous proposons également Google Pay™ pour les applications Android natives. Notre client SDK Android vous aide à intégrer Google Pay™ dans votre application tandis que nous déchiffrons pour vous les informations de paiement sensibles.

Une fois que vous avez suivi les directives d'installation de Google, vous êtes prêt à commencer l'intégration technique avec nous. Google offre un tutoriel très clair et concis sur la façon d'implémenter Google Pay™ sur votre site Web. L'intégration technique inclut les étapes suivantes :

• Récupérer Google Pay™
• Se conformer à l'authentification forte du client (SCA)
• Afficher le bouton Google Pay™
• Obtenir le token de paiement
• Envoyer le token de paiement

1. Récupérer Google Pay™

Google Pay™ peut ne pas être disponible sur tous les appareils. Le client SDK Android vous permet de masquer facilement Google Pay™ si tel est le cas. Notre plateforme renverra alors null. Utilisez l'exemple de code suivant pour effectuer cet appel :

// Vérifier la disponibilité de Google Pay™

private void getGooglePayPaymentProduct() {
    // la session est une instance déjà initialisée de l'objet GcSession du SDK
    session.getPaymentProduct(
        this,     // Instance du contexte d'application Android 
        Constants.PAYMENTPRODUCTID_GOOGLEPAY,
        paymentContext, 
        this.     // Mise en œuvre de OnPaymentProductCallCompleteListener
    );
}

/**
 * Mise en œuvre de la méthode de rappel pour récupérer un moyen de paiement
 */
@Override
public void onPaymentProductCallComplete(PaymentProduct paymentProduct) {
    if (paymentProduct != null) {
        if (Constants.PAYMENTPRODUCTID_GOOGLEPAY.equals(paymentProduct.getId())) {
            // Google Pay™ est disponible, affichez le bouton Google Pay™.
        } else {
            // Un produit différent a été récupéré..
        }
    } else {
        // Google Pay™ n'est pas disponible, nous ne devrions pas l'afficher. 
    }
}

2. Se conformer à l'authentification forte du client (SCA)

Si votre acquéreur est dans l'Espace économique européen (EEE), vous devez soumettre les informations du pays/région de la banque acquéreuse à Google dans TransactionInfo.countryCode. Cela garantira votre conformité aux exigences de SCA. Google Pay™ renverra les données de transaction correspondantes en fonction du pays/région de votre acquéreur.
L'appel d'API du moyen de paiement depuis le SDK Client ou le serveur-à-serveur renvoie le acquirerCountry que vous devez envoyer à Google. Le code suivant montre comment :

• obtenir le code du pays de l'acquéreur à partir de la réponse du moyen de paiement et l'utiliser pour initialiser Google Pay™.
• obtenir le champ de résultat de l'objet transactionInfo.
• spécifier les paramètres totalPrice et MerchantName (comme décrit dans l'étape 8.3 du tutoriel Google Pay™ et dans la section Authentification Forte du Client sur le site de documentation de Google).

Trouvez plus d'informations sur la conformité à l'authentification forte du client pour Google Pay™ dans la documentation de l'API Google Pay™ et dans notre guide dédié.

// Obtenir les paramètres de Google Pay™

private JSONObject initializeGooglePayValues(PaymentContext paymentContext, PaymentProduct googlePayProduct) {
    
    JSONObject paymentRequest = new JSONObject();
    try {
        // Initialiser d'autres valeurs de requête de paiement.

        JSONObject transactionInfo = new JSONObject();
        transactionInfo.put("totalPriceStatus", "FINAL");
        String totalPrice = formatAmount(paymentContext.getAmountOfMoney().getAmount().toString());
        transactionInfo.put("totalPrice", totalPrice);
        transactionInfo.put("currencyCode", paymentContext.getAmountOfMoney().getCurrencyCode().toString());
        if (paymentProduct.getAcquirerCountry() != null) {
            transactionInfo.put("countryCode", googlePayProduct.getAcquirerCountry());
        }
        paymentRequest.put("transactionInfo", transactionInfo);
        
    } catch (JSONException e) {
        // Un problème est survenu lors de la génération de l'entrée JSON de paiement.
    }
    
    return paymentContext;
}

/**
 * Formate le montant utilisé dans la plateforme Connect au format attendu par Google.
 */
private String formatAmount(String amount) {
    String formattedAmount = "00" + amount;
    formattedAmount = formattedAmount.substring(0, formattedAmount.length() - 2)
            + "."
            + formattedAmount.substring(formattedAmount.length() - 2);
    return formattedAmount;
}

3. Afficher le bouton Google Pay™

Si Google Pay™ est disponible, affichez le bouton Google Pay dans votre application. Assurez-vous de suivre les directives de Google sur l'affichage du bouton Google Pay™ et la politique de marque de Google.

4. Obtenir le token de paiement

Pour traiter le paiement réel, vous devez demander le token de paiement à Google. Pour ce faire, utilisez l'extrait de code suivant :

/**
 * Cette méthode extrait le token de paiement Google Pay™ de l'objet PaymentData 
 *    qui est renvoyé lorsque l'utilisateur a autorisé le paiement dans la feuille de paiement.
 * @param paymentData L'objet paymentData de Google Pay™ qui est renvoyé par la feuille de paiement.
 * @return Le token de paiement sous forme de chaîne au format accepté par notre
 *    API Create Payment.
 */
private String getGooglePayTokenFromPaymentData(PaymentData paymentData) {
    String json = paymentData.toJson();
    if (json != null && !json.isEmpty()) {
        try {
            JSONObject paymentDataJson = new JSONObject(json);
            return paymentDataJson
                    .getJSONObject("paymentMethodData")
                    .getJSONObject("tokenizationData")
                    .getString("token");
        } catch (JSONException e) {
            Log.e(TAG, "Le token de paiement n'est pas dans un format JSON valide");
        }
    } else {
        Log.e(TAG, "Seul le PaymentData au format JSON est accepté.");
    }
    return null;
}

5. Envoyer le token de paiement

Extrayez le token et envoyez-le à votre serveur via le SDK Serveur appel API Create Payment. Vous pouvez fournir le token de deux manières :

1. Envoyez le token dans la propriété mobilePaymentMethodSpecificInput.encryptedPaymentData. Assurez-vous d'envoyer également mobilePaymentMethodSpecificInput.paymentProductId
   

   
   {
      "mobilePaymentMethodSpecificInput":{
         "encryptedPaymentData":"{\"signature\":\"MEUCIQCcSASjWu3ax9jQ8qX/+rsNLZ95uiyxamXiKnHlJi8A1QIgZj ...",
         "paymentProductId":"320"
      }
   }
   

2. Spécifiez le token comme valeur de paiement dans encryptedCustomerInput. Cette entrée est une liste chiffrée de paires clé-valeur, contenant généralement les saisies de l'utilisateur, qui est compilée en fonction du champ de saisie réel. Les détails de paiement chiffrés du client :
   • sont chiffrés à nouveau
   • envoyés à votre serveur
   • enfin à notre serveur
     
     Vous devez utiliser le SDK Android côté client pour créer la valeur chiffrée CustomerInput. Le fieldId du champ de données de paiement chiffré est renvoyé lorsque Google Pay™ reçoit des moyens de paiement via l'API. Bien que ce champ soit renvoyé comme un champ de saisie, vous ne devriez pas fournir ce champ aux utilisateurs.

Requête de paiement avec CustomerInput chiffré
private void createPreparedPaymentRequestGooglePay(String token, PaymentProduct googlePay) {
    PaymentRequest paymentRequest = new PaymentRequest();
    paymentRequest.setPaymentProduct(googlePay); // C'est l'objet PaymentProduct Google Pay™, qui est le résultat de l'appel getPaymentProduct effectué précédemment
    
    if (token != null && !token.isEmpty()) {
        paymentRequest.setValue(Constants.GOOGLE_PAY_TOKEN_FIELD_ID, token);
    
        // Préparez la requête de paiement en chiffrant les valeurs de paiement
        session.preparePaymentRequest(
            paymentRequest, 
            this,     // Instance du contexte d'application Android 
            this      // Mise en œuvre de OnPaymentRequestPreparedListener 
        );
    } else {
        // Informez l'utilisateur qu'une erreur s'est produite
    }
}

/**
 * Mise en œuvre de la méthode de rappel pour le chiffrement des valeurs de paiement
 */
@Override
public void onPaymentRequestPrepared(PreparedPaymentRequest preparedPaymentRequest) {
    if (preparedPaymentRequest != null) {
        String encryptedFields = preparedPaymentRequest.getEncryptedFields();
        // Envoyez les encryptedFields à votre backend
    } else {
        // Un problème est survenu, informez l'utilisateur
    }
}

Cinématique

1. Vos clients finalisent une commande dans votre boutique / application et sélectionnent Google Pay™.
2. Votre serveur envoie un appel API spécifique à Google pour afficher une liste de méthodes de paiement prises en charge dans le navigateur / l'application.
3. Vos clients sélectionnent une méthode de paiement.
4. Votre serveur demande un token de paiement à Google.
5. Vous envoyez cette demande CreatePayment à notre plateforme, contenant le token de paiement dans la propriété mobilePaymentMethodSpecificInput.encryptedPaymentData
   5'(Optionnel pour les paiements passant par votre propre page de paiement). Si vos clients utilisent une carte non tokenisée par le réseau, vous redirigez les clients vers leur banque émettrice pour l'authentification 3-D Secure.
   5''(Optionnel pour les paiements passant par votre propre page de paiement). Vos clients effectuent la vérification 3-D Secure. Notre système reçoit le résultat de l'émetteur. Selon le résultat, deux scénarios sont possibles :
   a) Si l'identification a réussi, le flux continue à l'étape 6.
   b) Si l'identification a échoué, nous redirigeons vos clients vers votre returnUrl, mettant fin au flux. Vous pouvez demander le résultat de la transaction comme décrit à l'étape 8.
6. Google Pay™ traite la transaction financière réelle. Nous recevons le résultat de la transaction.
7. Nous redirigeons votre client vers votre application / returnUrl
8. Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails ou recevez le résultat via webhooks.
9. Si la transaction a réussi, vous pouvez livrer les biens / services.

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.