Sur cette page
- Identifier le compte MPGS avant sa configuration
- Direct et Hosted Checkout sont des intégrations distinctes
- Parcours du paiement HighLevel
- Configuration de MPGS dans Genius Checkout
- Connecter le lieu HighLevel
- Tester le parcours de retour complet
- Diagnostic d’un « Impossible de démarrer le paiement » ou HTTP 502
- Les paiements récurrents nécessitent la tokenisation
- Réutiliser la connexion MPGS au-delà de HighLevel
- Questions fréquentes des commerçants
- Sources
Genius Checkout connecte un compte Mastercard Payment Gateway Services pris en charge à HighLevel, en tant que fournisseur de paiement personnalisé. Le commerçant conserve sa relation bancaire et MPGS. Genius Checkout crée la session de paiement, gère la redirection vers le paiement et retransmet le résultat à HighLevel.
Ce guide décrit la mise en œuvre Genius Checkout revue au 4 septembre 2026. Merci de vérifier les URLs de la passerelle, les devises, la tokenisation et les autorisations de transaction auprès de la banque ou du prestataire ayant émis le compte MPGS.
| Détail de la connexion | Prise en charge actuelle Genius Checkout |
|---|---|
| Noms de plateformes | HighLevel, GoHighLevel, GHL, LeadConnector |
| Noms de passerelles | Mastercard Payment Gateway Services, MPGS, Mastercard Gateway |
| Modes de la passerelle | MPGS Direct et MPGS Hosted Checkout |
| Paiements ponctuels | Pris en charge |
| Prélèvements récurrents | Pris en charge si le compte et la méthode fournissent un jeton réutilisable |
| Règlement | Géré selon l'accord banque ou acquéreur du commerçant |
Le commerçant gère le branding Genius Checkout et les moyens de paiement activés. Le prestataire détermine les opérations de passerelle autorisées pour le compte.
Identifier le compte MPGS avant sa configuration
Les banques et prestataires délivrent les comptes MPGS avec un identifiant marchand (Merchant ID), un hôte régional pour la passerelle et des identifiants d’authentification. Un portail bancaire en marque blanche peut utiliser la technologie MPGS sans garantir que le mode Genius Checkout soit le bon — le nom du portail seul n’est pas suffisant.
Vérifiez dans le package de bienvenue et le portail de la passerelle :
- Le Merchant ID.
- L’URL de base de la passerelle ou sa région.
- Mot de passe API ou identifiants opérateur pour Direct.
- Autorisations Hosted Checkout et paramètres marchand pour HPP.
- La distinction entre test et production.
- Les devises activées.
- Les autorisations de tokenisation et de paiements récurrents.
Utilisez « votre banque, par exemple Sagicor » lorsque vous expliquez qui fournit l’accès MPGS. Ne dites jamais qu’une banque utilise MPGS pour chaque commerçant ou pays sans confirmation pour ce compte précis.
Direct et Hosted Checkout sont des intégrations distinctes
Les deux modes accèdent au même compte marchand mais impliquent des demandes et des parcours différents pour l’acheteur.
| Décision | MPGS Direct | MPGS Hosted Checkout |
|---|---|---|
| Interface de paiement | Genius Checkout orchestre le flux Direct | MPGS affiche le Hosted Checkout |
| Authentification | Identifiants API attribués ou créés pour le marchand | Configuration Hosted Checkout et accès à l’API de session |
| Branding | Géré dans Genius Checkout dans la limite de la passerelle | Logo et présentation paramétrés côté MPGS |
| Comportement du navigateur | Dépend de l’authentification carte et du process | S’ouvre comme page hébergée par le prestataire, peut nécessiter une navigation en niveau supérieur |
| Portée conformité | À valider au cas par cas sur l’implémentation | À valider au cas par cas sur l’implémentation |
Les accès et paramètres du commerçant déterminent quels modes peuvent être activés. Un mot de passe API ne remplace pas la configuration Hosted Checkout ; inversement, une configuration Hosted Checkout ne donne pas automatiquement accès à Direct.
Parcours du paiement HighLevel
HighLevel transmet les champs de commande et d’acheteur supportés à Genius Checkout. Genius Checkout génère une session unique de paiement et sélectionne la route MPGS prévue pour la devise de la transaction.
Pour Hosted Checkout, l’acheteur est redirigé vers la page MPGS. Les pages prestataires peuvent interdire l’affichage dans un iframe tiers : Genius Checkout opte alors pour une redirection sécurisée en niveau supérieur et retransmet le résultat à HighLevel.
Pour Direct, Genius Checkout gère le paiement et l’authentification carte selon le flux configuré. La plateforme consigne la réponse du prestataire, génère sa propre historique de transactions, et transmet le statut à HighLevel.
Configuration de MPGS dans Genius Checkout
- Ouvrez Gateways dans le compte marchand Genius Checkout approprié.
- Sélectionnez MPGS Direct ou MPGS Hosted Checkout.
- Choisissez le mode test ou production.
- Renseignez le Merchant ID, les identifiants et l’URL de passerelle correspondant à ce mode.
- Sélectionnez uniquement les devises autorisées par la banque ou le prestataire.
- Ajoutez le logo Hosted Checkout via la médiathèque lorsque vous utilisez HPP. Une image source carrée de 1000 x 1000 pixels facilitera le redimensionnement.
- Enregistrez et résolvez tous les messages de validation affichés.
Utilisez les valeurs délivrées pour le mode MPGS et l’environnement choisis. Une URL de test couplée à des identifiants production produira un échec.
Connecter le lieu HighLevel
- Ouvrez le lieu HighLevel propriétaire des produits et paiements.
- Installez ou ouvrez Genius Checkout dans le HighLevel App Marketplace en tant que fournisseur de paiement personnalisé.
- Autorisez l’accès au compte marchand Genius Checkout concerné.
- Vérifiez le nom du marchand affiché lors de la connexion.
- Ajoutez Genius Checkout à un produit de test sous contrôle.
- Testez séparément les paiements ponctuels et récurrents.
Nom, e-mail, téléphone, adresse, référence de commande et autres champs supportés peuvent être transmis à Genius Checkout lorsque HighLevel les fournit. L’intégration ne doit jamais inventer d’informations client manquantes.
Tester le parcours de retour complet
Consignez pour chaque test : la commande HighLevel, la transaction Genius Checkout, le reçu, la référence MPGS, le timestamp UTC, le mode, l’environnement et le résultat.
Testez les cas suivants :
- Paiement réussi.
- Paiement refusé.
- Annulation de l’acheteur depuis la page MPGS.
- Action « Retour » du navigateur depuis Hosted Checkout.
- Retour réussi vers la confirmation HighLevel.
- Paiement avec carte enregistrée si la tokenisation est activée.
- Mise en place d’abonnement et renouvellement initié par le marchand si paiements récurrents activés.
- Remboursement ou annulation depuis le système utilisé par votre équipe opérations.
Les commandes « Retour » et « Annuler » du Hosted Checkout doivent permettre à l’acheteur de quitter le parcours. Une boucle qui renvoie automatiquement vers MPGS doit être corrigée avant la mise en ligne.
Diagnostic d’un « Impossible de démarrer le paiement » ou HTTP 502
Un code HTTP 502 lors du lancement MPGS indique un échec d’intégration ou de prestataire en amont, pas un refus de paiement. Vérifiez le journal API Genius Checkout et l’ID de corrélation, puis confirmez :
- Le marchand a bien une configuration MPGS active dans le mode sélectionné.
- L’URL de la passerelle correspond à l’environnement des identifiants.
- La devise est activée dans Genius Checkout ET dans MPGS.
- L’identifiant marchand ne comprend aucun espace caché.
- Les autorisations Hosted Checkout sont bien établies.
- La passerelle amont a répondu dans le délai imparti.
Genius Checkout doit créer un journal d’exploitation même si MPGS échoue avant tout engagement financier. Ce journal est indispensable pour distinguer une erreur prestataire d’un problème de plateforme.
Les paiements récurrents nécessitent la tokenisation
Un paiement ponctuel réussi ne garantit pas la capacité d’abonnement. Le compte doit permettre les jetons de paiement réutilisables et le comportement transactionnel initié par le marchand. Genius Checkout vérifie aussi que le plan l’autorise.
Un nouvel essai de prélèvement crée une nouvelle tentative et transaction. L’échec précédent est maintenu afin que chaque système conserve une piste d’audit complète.
Réutiliser la connexion MPGS au-delà de HighLevel
Le marchand configure MPGS une seule fois dans Genius Checkout. Les modes et capacités activés déterminent les connexions suivantes possibles :
- Boutiques WooCommerce.
- Vitrines Ecwid.
- Formulaires de dons GiveWP.
- Liens de paiement hébergés et paiements par QR code.
- Applications personnalisées via la documentation API Genius Checkout.
Testez chaque intégration logicielle. Les URLs de retour, la synchronisation des statuts, le fonctionnement carte enregistrée et les points d’entrée pour les remboursements varient d’une plateforme à l’autre.
Questions fréquentes des commerçants
Le service Sagicor eCommerce fonctionne-t-il avec HighLevel ?
Un commerçant peut utiliser son compte MPGS fourni par sa banque, par exemple Sagicor, avec cette intégration HighLevel. Configurez bien l’hôte, le mode, les identifiants, devises et autorisations attribués au compte. Voir la présentation Sagicor eCommerce.
Peut-on afficher MPGS Hosted Checkout dans l’iframe HighLevel ?
Les en-têtes de sécurité peuvent bloquer l’affichage intégré. Genius Checkout utilise une redirection sécurisée en niveau supérieur si nécessaire et retransmet le résultat à HighLevel.
Genius Checkout gère-t-il le règlement ?
Non. La banque ou le prestataire du commerçant traite et règle les fonds selon son contrat.
Où consulter chaque champ MPGS ?
Référez-vous à la vue d’ensemble MPGS et au guide détaillé Genius Checkout MPGS.
Sources
- Documentation API Mastercard Gateway
- Documentation paiements personnalisés HighLevel
- Genius Checkout dans le HighLevel App Marketplace
- Présentation Genius Checkout MPGS
- Présentation Genius Checkout HighLevel
Besoin d’aide pour identifier le mode sans divulguer de données sensibles ? Réservez un audit de connexion.