Comment intégrer Sagicor eCommerce (MPGS) en Jamaïque

Pour intégrer Sagicor eCommerce en Jamaïque, demandez d’abord à Sagicor Bank d’approuver votre service d’acceptation des paiements en ligne. Vérifiez si le compte prend en charge MPGS Direct ou MPGS Hosted Checkout, créez les identifiants API nécessaires dans le portail marchand Mastercard, configurez l’option Sagicor MPGS correspondante dans Genius Checkout, testez l’ensemble du parcours de paiement, puis répétez la configuration avec les identifiants de production.

Chaque paramètre doit correspondre au compte approuvé par Sagicor pour votre entreprise. Avoir un accès au portail n’implique pas nécessairement l’activation de l’API Direct, Hosted Checkout, la tokenisation, les paiements récurrents, les remboursements ni toutes les devises.

Dernière vérification : 25 septembre 2026.

#Rôle de chaque partie

Sagicor décrit sa Payment Gateway Solution comme une solution permettant aux entreprises de traiter des paiements en ligne. L’approbation, la tarification, les délais de règlement, l’acceptation cartes et les exigences de conformité restent régis par le contrat marchand en vigueur avec la banque.

#1. Demandez le service marchand Sagicor adapté

Expliquez à la banque comment l’entreprise souhaite encaisser avant de solliciter des identifiants techniques. Un hôtel acceptant des acomptes, un e-commerçant expédiant des produits, ou une structure de membres facturant des abonnements récurrents nécessitent des options différentes.

Demandez à Sagicor de confirmer par écrit :

• La raison sociale et l’ID marchand.
• Si le compte utilise MPGS Direct, Hosted Checkout, ou les deux.
• Les URLs du portail marchand en test et en production.
• Les devises et marques de cartes activées.
• Si 3-D Secure est requis et actif.
• Si PURCHASE est autorisé pour un encaissement immédiat.
• Si AUTHORIZE puis CAPTURE sont autorisés.
• Si les annulations, remboursements complets ou partiels sont activés.
• Si la tokenisation et les paiements récurrents à l’initiative du marchand sont permis.
• Le compte bancaire de règlement et les devises correspondantes.

Ne choisissez pas Direct ou Hosted Checkout uniquement sur la base d’une capture d’écran ou du paramétrage d’un autre client : utilisez le pack d’onboarding propre à votre identifiant marchand.

#2. Choisissez MPGS Direct ou Hosted Checkout

Les deux options permettent d’accepter un paiement en ligne par carte, mais elles diffèrent dans l’expérience client et les prérequis du compte.

Si l’entreprise souhaite vendre des abonnements ou proposer un essai gratuit puis facturer ultérieurement, clarifiez la question de la tokenisation avant de créer le site. Un paiement unique réussi ne signifie pas que le compte autorise la sauvegarde de moyen de paiement réutilisable.

#3. Créez le mot de passe API MPGS

Le portail d’administration marchand MPGS fourni par Sagicor se trouve fréquemment à l’adresse sagicorbank.gateway.mastercard.com/ma. Utilisez le lien du mail de bienvenue si Sagicor indique une URL différente.

Le mot de passe de connexion au portail et le mot de passe API sont deux identifiants différents. Pour préparer l’accès API :

1. Connectez-vous avec l’administrateur marchand fourni par la banque.
2. Rendez-vous dans Admin → Opérateurs et créez un opérateur si aucun n’est encore associé à l’intégration.
3. Connectez-vous avec le bon opérateur.
4. Accédez à Admin → Integration Settings → Edit.
5. Générez et activez Password 1 pour l’accès API.
6. Stockez ce mot de passe dans un gestionnaire de mots de passe. Ne l’envoyez ni par email, ni en capture d’écran, ni dans un dépôt de code.

Genius Checkout attend comme nom d’utilisateur API merchant.<Merchant ID>. Dans le champ de configuration, indiquez seulement l’ID marchand, sans le préfixe merchant., sauf si les instructions le spécifient.

#4. Configurez Sagicor MPGS dans Genius Checkout

Commencez en mode test pour éviter tout impact sur les commandes en production en cas d’erreur de paramétrage.

1. Connectez-vous au compte marchand Genius Checkout qui gèrera les paiements.
2. Allez dans Passerelles.
3. Sélectionnez MPGS Direct ou MPGS Hosted Checkout selon le mode approuvé.
4. Choisissez le préréglage régional Sagicor si disponible.
5. Saisissez https://sagicorbank.gateway.mastercard.com comme URL de base, sauf indication contraire de Sagicor.
6. Entrez l’ID marchand et le mot de passe API correspondant à l’environnement de test ou de production.
7. Laissez la version API par défaut, sauf demande expresse du support technique Sagicor ou de l’onboarding.
8. Activez uniquement les devises validées pour ce compte marchand.
9. Sélectionnez Autoriser & Capturer pour un encaissement immédiat ou Autoriser seulement si l’entreprise a un motif approuvé et un processus cadré pour la capture différée.
10. Enregistrez la configuration et lancez Test de connexion.

Le test de connexion authentifie et initialise une session MPGS vide, sans débit de carte. Un test réussi prouve que l’hôte et les identifiants fonctionnent, pas l’aboutissement d’un paiement complet, défi 3-D Secure, capture ou remboursement.

Consultez le guide complet de configuration MPGS avant de finaliser les réglages.

#5. Connectez le logiciel déjà utilisé par l’entreprise

Une fois le compte MPGS validé dans Genius Checkout, vous pouvez accepter des paiements via le canal le plus approprié :

• Générez des liens de paiement et QR codes pour factures, ventes WhatsApp, acomptes, ou règlements en magasin.
• Connectez WooCommerce pour une boutique WordPress.
• Connectez HighLevel pour tunnels de vente, agences, adhésions et ventes pilotées par CRM.
• Connectez Ecwid ou GiveWP si ces plateformes conviennent à l’activité.
• Utilisez l’API Genius Checkout pour intégrer via un site ou logiciel personnalisé.

Pour WordPress, référez-vous au guide spécifique d’intégration MPGS et WooCommerce. Il détaille les réglages d’extension, l’autorisation du domaine, les notes de commande, renouvellement, annulation et traitement des remboursements, sans répéter ici l’étape d’onboarding bancaire.

#6. Testez plus d’un paiement réussi

La validation avant lancement doit couvrir les cas que l’entreprise devra gérer après la mise en ligne du site.

Conservez l’ID de la commande test, l’ID de transaction Genius Checkout, la référence MPGS, l’heure UTC, l’environnement et le résultat. Ne jamais noter le numéro de carte complet ni le cryptogramme.

#7. Passez de la préproduction à la production sans mélanger les identifiants

Prévoyez des configurations distinctes pour test et production. Pour activer les paiements réels :

1. Confirmez auprès de Sagicor l’activation de l’ID marchand et des fonctionnalités requises en « live ».
2. Renseignez l’ID marchand de production et son mot de passe API dans l’espace production de Genius Checkout.
3. Activez uniquement les devises homologuées en production.
4. Autorisez le domaine du site public si requis par l’intégration.
5. Réalisez un paiement réel contrôlé à faible montant avec une carte approuvée.
6. Vérifiez la commande, la transaction Genius Checkout, la transaction MPGS, le reçu, l’email et le relevé bancaire attendu.
7. Testez une annulation ou un remboursement tant que l’équipe de lancement est disponible.

N’utilisez jamais le mot de passe test en production et n’en déduisez pas que toute fonctionnalité activée en test l’est en production.

#Problèmes courants lors de la configuration Sagicor MPGS

#Échec d’authentification

Vérifiez la cohérence entre ID marchand, mot de passe API, URL de base et environnement. Réinitialiser le mot de passe du portail ne crée pas un nouveau mot de passe API.

#Hosted Checkout ne s’ouvre pas

Vérifiez auprès de Sagicor si Hosted Checkout est activé sur le profil marchand. Assurez-vous aussi que la page s’ouvre en tant que fenêtre principale du navigateur (et non dans une iframe qui pourrait être bloquée par la passerelle).

#Paiement réussi mais échec sur l’abonnement

Le compte peut autoriser les achats sans activer la tokenisation ou les transactions à l’initiative du marchand. Vérifiez les options activées à la banque et côté Genius Checkout.

#Devises refusées

La devise du site, celle de la passerelle Genius Checkout, et la devise activée par Sagicor doivent concorder. Le simple affichage d’une devise dans un menu ne garantit pas son activation sur le compte marchand.

#L’acheteur revient mais la commande n’est pas mise à jour

Contrôlez le callback de la passerelle, l’URL de retour, la livraison du webhook et le statut final MPGS. Ne marquez jamais une commande comme payée juste après une redirection navigateur.

#Foire aux questions

#Sagicor eCommerce et MPGS, est-ce la même chose ?

Sagicor fournit la relation marchande et la passerelle à l’entreprise cliente. MPGS est la technologie de Mastercard sur laquelle repose cette intégration. Suivez les règles d’onboarding Sagicor et utilisez les identifiants prévus pour votre profil marchand Sagicor.

#Ai-je besoin d’un compte bancaire pro Sagicor ?

Les exigences en matière de compte bancaire et de règlement sont déterminées par Sagicor. Demandez à la banque quel compte professionnel, documents de conformité et contrat marchand s’appliquent à votre société.

#Puis-je utiliser MPGS sans WooCommerce ?

Oui. Genius Checkout peut exposer une configuration MPGS approuvée via lien de paiement, QR code, intégration logicielle compatible ou développement API. Le meilleur usage dépend du process métier, pas seulement de la passerelle.

#Genius Checkout peut-il valider ma demande d’ouverture de compte marchand ?

Non. Sagicor décide seule de l’approbation, du règlement, de la tarification et des fonctions de la passerelle. Genius Checkout assure la connexion au logiciel une fois le service marchand activé.

#Références officielles et prochaine étape

• Sagicor Payment Gateway Solutions
• Solutions d’encaissement Sagicor pour entreprises
• Documentation API Hosted Checkout Mastercard
• Présentation de MPGS par Genius Checkout
• Guide de configuration MPGS par Genius Checkout

Créez votre compte Genius Checkout ou planifiez un audit d’intégration muni de vos informations d’onboarding Sagicor.