Contenu
Comment configurer votre compte ?
Vous devez vous rapprocher de votre responsable de compte pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (liste des contrats VAD).
Ensuite veuillez adresser un email à notre équipe support avec les noms des contrats VAD, le nom et l'identifiant marchand associé. que vous souhaitez associer à Google Pay, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline.
Contactez le support Monext Online.
Le code (card_code) du moyen de paiement est : GOOGLE_PAY
Option allowedAuthMethod
Vous pourrez sélectionner le mode 3DS ou PAN. Le mode 3DS vous permet de vérifier l’enrôlement de la carte bancaire pour un paiement mobile et d'obtenir le transfert de responsabilité.
Si le mode allowerdAuthMethod='Crypto3DS' (MODE 3DS) alors le moyen de paiement n 'est pas affiché sur desktop.
Option Parcours client
Vous pourrez sélectionner l'affichage de Google Pay en première position si une carte est enregistrée dans le portefeuille électronique sur le navigateur Chrome.
Affichage
Ce moyen de paiement ne s'affiche pas sur iOS.
L'affichage du moyen de paiement de Google Pay est disponible uniquement sur tous les navigateurs Chrome desktop et mobile. Le plugin de Google Pay ne s'ouvre pas dans des Webviews intégrées à une papplication Android. Vous pouvez utiliser la fonction chrome custom Tab.
API WebPayment de Payline
Pour les champs Identifiant du commercant (numérique) et Nom du commercant, vous devez vous enregistrer sur l'API Google Pay pour obtenir un accès Google Pay Developer Profile menu Web Developper (obligatoire).
Pour le champ allowedAuthMethod, vous devez sélectionner l'option 'Les deux'.
- Le mode PAN permet d’accepter uniquement les cartes non enrôlées par Google Pay. Ces cartes pourront être soumises à une authentification forte lors du paiement.
- Le mode 3DS permet d’accepter uniquement les cartes enrôlées par Google Pay. Ces cartes ne seront pas soumises à une authentification forte lors du paiement car Google a déjà réalisé une authentification lors de l’enrôlement.
Suivez les liens vers la documentation Google Pay Web developer documentation, Google Pay Web integration checklist and Google Pay Web Brand Guidelines.
Lors de l’inscription
- Pour le mode redirection : le commerçant doit déclarer l’url https://webpayment.payline.com auprès de Google et communiquant des screenshots du parcours d’achat.
- Pour le mode widget : le commerçant doit déclarer son nom de domaine de leur site web et communiquant des screenshots du parcours d’achat.
API DirectPayment de Payline
Pour l'intégration du SDK Android l'APK, l'url (com.example.shop) doit être whistelisté auprès de Google Pay. Vous devez vous enregistrer sur l'API Google Pay sur Google Pay Developer Profile menu Android Documentation.
Suivez les liens vers la documentation Google Pay Android developer documentation, Google Pay Android integration checklist and Google Pay Android brand guidelines.
Tous les marchands doivent adhérer à la politique d'utilisation acceptable des API Google Pay et accepter les conditions définies dans les conditions d'utilisation de l'API Google Pay.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.
Intégration de Google Pay : Utilisation du JWT pour contourner la limite des noms de domaine
Afin de dépasser la restriction liée au nombre des noms de domaine (max 99) par commerçant lors de l’intégration de Google Pay, il est désormais possible d’utiliser la fonctionnalité JWT (JSON Web Token).
Veuillez suivre les étapes pour activer le JWT sur le compte Google du commerçant.
Cette opération doit être renouvelée chaque année. Contact Google : googlepay-api-support@google.com
Générer un certificat de clé asymétrique côté commerçant (clé privée/clé publique).
Demander d’activation du JWT auprès de Google.
- Envoyer la clé publique du certificat généré à Google.
Configuration dans le centre administration Monext
- Renseigner le champ nom de domaine dans le moyen de paiement (ex. :
marchand.com
). - Si plusieurs noms de domaine sont utilisés pour un même contrat, il est possible de les surcharger via le champ
merchantOrigin
dansmiscData
de la trame de paiement.
- Renseigner le champ nom de domaine dans le moyen de paiement (ex. :
Ajouter de la clé
authJWT
dans le champmiscData
de la trame de paiement.Valider le fonctionnement uniquement en environnement de production.
Appliquer cette configuration à d’autres moyens de paiement :
Veuillez contacter notre support en fournissant toutes les informations nécessaires.
Exemple de champ miscData
:
Nom de domaine renseigné dans la trame (plusieurs noms de domaine par contrat)
<impl:miscData>{"GOOGLE_PAY_CB" "{'merchantOrigin':'merchant.com', 'authJWT':'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'}"}</impl:miscData>
Nom de domaine renseigné dans le contrat (un seul nom de domaine par contrat)
<impl:miscData>{"GOOGLE_PAY_CB" "{'authJWT':'xxxxxxxxxxxxxxxxxxxxxx'}"}</impl:miscData
Comment proposer le paiement Google Pay à vos clients ?
Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline.
Les mode d’intégrations en mode API WebPayment et API DirectPayment sont disponibles.
Les web services en mode Web
Les services doWebPayment et getWebPaymentDetails sont disponibles.
L'object Payment sera transmis par le commerçant avec les valeurs Action et Mode.
Le service getWebPaymentDetails retourne le résultat de la transaction.
Les web services en mode Direct
En direct, le commerçant doit se référer à la documention de Google pour créer un JavaScript permettant initier le paiement, afficher le bouton et gérer l'évènement CallBack du Widget de Google.
Ensuite il devra récupérer le Payload de Google Pay, à transmettre dans la demande d'autorisation à Payline dans le paymentData.TokenData
Lors de la second étape "choix de la méthode de tokenisation" de la documentation de Google Pay, vous devez obligatoirement mettre à jour les champs suivants :
- champ gateway doit contenir la valeur 'monext';
- champ gatewayMerchantId doit contenir la valeur 'PAYLINE', correspondant à l'identifiant commerçant définit lors de la configuration du compte Google Pay.
Les services de paiement disponibles :
- Le service doAuthorization pour réaliser une demande de paiement sur le contrat Google Pay.
- Les services de gestion de caisse (validation, annulation, remboursement) se font sur le contrat du paiement.
En mode direct, si un payload est renseigné alors la valeur de card.panType sera valorisé comme indiqué ci dessous :
- Les transactions GooglePay en mode PAN doivent être identifiées avec panType = CARD PAN
- Les transactions GooglePay en mode CRYPTO_3DS doivent être identifiées avec panType = DEVICE_TOKEN
Les champs obligatoires
Les mêmes champs que pour une transaction de type carte bancaire.
Comment réaliser des tests ?
Sur l'environnement de test, vous devez réaliser des tests à partir d'un compte Google qui retournera une carte de test à la place de votre carte réel.
Les codes de retour
Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. Les états retournés : La gestion des états et des codes retour sont listés ici.