Comment intégrer Powertranz en Jamaïque

Pour intégrer Powertranz en Jamaïque, il faut obtenir un contrat de commerçant eCommerce auprès d’une banque ou d’un acquéreur qui prend en charge Powertranz, vérifier si le compte utilise Powertranz Direct ou la Hosted Payment Page (HPP), configurer les identifiants de test correspondants dans Genius Checkout, connecter le site ou la plateforme commerciale, réaliser des tests complets, puis activer la configuration en production séparée.

Powertranz était auparavant connu sous le nom de First Atlantic Commerce ou FAC. Les anciens formulaires bancaires, e-mails d’identifiants et libellés du portail peuvent toujours utiliser le nom FAC, bien qu'ils designent la même famille de passerelle. Powertranz a annoncé le changement de marque en mai 2025.

Dernière vérification : 25 septembre 2026.

#Quelles banques jamaïcaines connectent les commerçants à Powertranz ?

En Jamaïque, Genius Checkout prend actuellement en charge les comptes commerçants Powertranz délivrés par les établissements suivants :

• National Commercial Bank Jamaica, affiché comme JNCB.
• First Global Bank.
• CIBC Caribbean.
• Scotiabank Jamaica.

Chaque institution doit approuver votre entreprise et préciser ses produits actuels, devises, modalités de règlement et conditions d’intégration. Demandez explicitement un compte marchand paiement par carte en ligne, acquitement eCommerce, ou Powertranz/FAC.

Vérifiez précisément le processeur du produit approuvé avant de saisir quelque identifiant que ce soit. Une banque peut proposer plusieurs services de paiement distincts, et les identifiants d’une autre passerelle ne sont pas interchangeables avec ceux de Powertranz.

La page eCommerce de la NCB est un exemple public : la NCB y décrit une page de paiement hébergée propulsée par Powertranz, anciennement FAC. Une autre banque pourra proposer le traitement Direct, HPP, ou un autre pack commercial. Genius Checkout ne remplace pas le contrat d’acquisition. Il fournit la couche logicielle reliant un contrat commerçant validé aux outils de vente de l’entreprise.

#Commencez par le cas d’usage commercial, pas par le formulaire d’identifiants

La banque va évaluer ce que l’entreprise propose, la manière dont les acheteurs reçoivent le produit, les montants attendus, le risque de remboursement, les devises et les contrôles contre la fraude. Présentez une description d’activité claire avant de postuler.

Par exemple :

• Un hôtel peut nécessiter arrhes, soldes, annulations, et le USD en plus du JMD.
• Une entreprise d’adhésion peut avoir besoin de jetons de paiement réutilisables et de prélèvements récurrents initiés par le commerçant.
• Un détaillant devra gérer la capture immédiate, les remboursements partiels, et des preuves de livraison.
• Un consultant voudra seulement envoyer des liens de paiement pour des factures et des acomptes.
• Un organisateur d’événements peut chercher un paiement par QR code et des remboursements fiables.

Demandez à la banque ou à l’équipe d’intégration de confirmer :

• Les identifiants marchands de test et de production.
• Les mots de passe de traitement de test et de production.
• Les devises autorisées et les comptes de règlement.
• L’activation du mode Direct, HPP ou les deux.
• Les exigences 3-D Secure.
• La capacité SALE ou capture immédiate.
• Les capacités AUTHORIZE, CAPTURE différé, annulation, remboursement total et partiel.
• L’autorisation de la tokenisation et des paiements récurrents.
• Pour HPP, le PageSet et le PageName exacts.
• Si le profil du portail porte la mention FAC ou Powertranz.

Le mot de passe de connexion au portail n’est pas forcément le mot de passe de traitement des paiements. Ne les réutilisez jamais même si les libellés semblent similaires.

#Choisir entre Powertranz Direct ou HPP

Le mode optimal dépend du compte approuvé et de l’expérience d’achat recherchée par l’entreprise.

Powertranz détaille sa Hosted Payment Page comme une redirection vers une page fournisseur sécurisée. Cette distinction est essentielle pour les plateformes utilisant des iframes : l’intégration initiale peut être intégrée, mais la page hébergée externe s’affichera souvent au niveau principal du navigateur.

#Configurer Powertranz dans Genius Checkout

Commencez par le mode test.

1. Connectez-vous au compte marchand Genius Checkout qui recevra les paiements.
2. Ouvrez Passerelles.
3. Sélectionnez Powertranz Direct ou Powertranz HPP selon votre pack d’intégration.
4. Saisissez le Merchant ID de test et le mot de passe de traitement de test.
5. Pour HPP, renseignez exactement le PageSet et le PageName fournis, et sélectionnez le bon type de portail FAC ou Powertranz.
6. Activez uniquement les devises autorisées sur ce compte commerçant.
7. Pour Direct, choisissez Autoriser & Capturer pour un débit immédiat, ou Autoriser uniquement si le commerçant a un processus spécifique de capture différée.
8. Activez 3-D Secure, la vérification d’adresse ou la tokenisation uniquement si ces fonctions sont validées et nécessaires à l’activité.
9. Enregistrez et résolvez tout retour de validation.
10. Effectuez le test de connexion puis réalisez un paiement contrôlé.

Genius Checkout utilise l’endpoint de staging Powertranz en test, et la passerelle de production ensuite. Maintenez l’alignement entre Merchant ID, mot de passe, devise, environnement et clé API du site. Un problème fréquent vient de l’utilisation d’une valeur réelle dans une configuration test, ou inversement.

Le guide de configuration Powertranz détaille chaque champ et sa provenance.

#Connecter Powertranz au mode de vente de l’entreprise

Une fois la passerelle fonctionnelle, reliez-la au canal qui résout le problème métier :

• Utilisez les liens de paiement et QR codes pour factures, acomptes, ventes WhatsApp ou paiements physiques.
• Connectez WooCommerce pour une boutique WordPress.
• Connectez HighLevel pour tunnels de vente, CRM, agences ou adhésions.
• Connectez Ecwid ou GiveWP si ces outils correspondent à votre activité.
• Utilisez l’API Genius Checkout pour une application personnalisée validée.

Les commerçants WordPress peuvent suivre le guide Powertranz et WooCommerce. Les utilisateurs HighLevel peuvent suivre le guide Powertranz et HighLevel. Ces pages détaillent chaque intégration tandis que cet article traite l’intégration jamaïcaine au sens large.

#Un test de lancement en Jamaïque qu’il faut effectuer

Ne vous arrêtez pas dès le premier paiement approuvé. Testez tout le parcours de l’acheteur jusqu’à la comptabilisation côté commerçant.

#Données acheteur et commande

• Le nom de l’entreprise, le contact SAV, le montant et la devise sont corrects.
• Nom, email, téléphone et adresse de facturation de l’acheteur restent précis.
• Chaque tentative crée une transaction Genius Checkout et un ordre de passerelle unique.
• Une nouvelle tentative ne tente pas de retraiter une transaction financière échouée.

#États de paiement

• Paiement carte approuvé.
• Refus sécurisé avec message explicite.
• Défi 3-D Secure et retour.
• Annulation acheteur ou retour navigateur.
• Redirection HPP au niveau principal le cas échéant.
• Réception multiple de callback sans double débit.
• Autorisation, capture, annulation, remboursement total et partiel si autorisés.

#Utilisation récurrente

• Sauvegarder un moyen de paiement seulement après consentement du client.
• Vérifier que le token retourné appartient au bon commerçant et client.
• Tester la configuration d’un essai à montant zéro si le site le propose.
• Déclencher le premier renouvellement payant.
• Provoquer un échec de renouvellement puis une relance manuelle.
• S’assurer que chaque tentative utilise un nouvel identifiant d’ordre côté passerelle.

En mode test, utilisez les cartes de test approuvées par le fournisseur. Pour la validation finale, faites un paiement réel de faible montant appartenant à l’équipe projet. N’effectuez jamais de test sur une vraie commande ou un email client réel.

#Passer en production en toute sécurité

1. Confirmez que la banque ou Powertranz a activé le profil commerçant réel.
2. Saisissez le Merchant ID, le mot de passe de traitement et les champs HPP de production dans Genius Checkout.
3. Vérifiez les devises et actions de paiement en mode production.
4. Autorisez le domaine du site internet de production si nécessaire.
5. Effectuez un paiement réel de faible montant.
6. Comparez commande sur le site, transaction Genius Checkout, enregistrement Powertranz, reçu et détails de règlement attendus.
7. Testez la fonction annulation ou remboursement applicable.
8. Précisez qui gérera les refus, litiges, remboursements et rapprochements après lancement.

Séparez toujours les identifiants test et production, même si le Merchant ID semble similaire.

#Problèmes courants d’intégration Powertranz

#« Aucun mode de paiement n’est configuré »

La clé API du site peut appartenir à un autre commerçant Genius Checkout ou environnement. Vérifiez le nom du commerçant affiché par l’intégration avant de modifier la configuration passerelle.

#« Duplicate order ID not allowed »

Chaque paiement, renouvellement ou relance nécessite un nouvel identifiant côté passerelle. Conservez le numéro de commande du site comme métadonnée, mais ne le réutilisez jamais comme identifiant de tentative de paiement.

#HPP n’ouvre aucune fenêtre de paiement

Le navigateur bloque peut-être un pop-up, ou bien le flux traite à tort une redirection de niveau principal en iframe. Une redirection standard doit mener directement à la page hébergée, une plateforme intégrée requiert un basculement explicite au niveau principal.

#Un paiement ponctuel fonctionne mais un renouvellement échoue

Vérifiez la tokenisation, le mode Card-on-File, l'autorisation de paiement récurrent, la validité du token stocké, et les capacités du plan. Un succès en HPP ne prouve pas l’activation de la tokenisation en Direct.

#Les données acheteur contiennent des valeurs non saisies par le client

N’inventez jamais d’adresse pour remplir un champ optionnel. Transmettez uniquement les données fournies par l’acheteur ou la plateforme, normalisez prudemment les caractères non valides, et consignez ce qui a été envoyé sans stocker de données carte interdites.

#Foire aux questions

#FAC et Powertranz, est-ce la même chose ?

Powertranz est la marque actuelle de la passerelle anciennement appelée First Atlantic Commerce. Des intégrations ou documents bancaires anciens peuvent encore porter le nom FAC.

#Dois-je postuler auprès de Genius Checkout ou de la banque ?

Postulez auprès d’une banque ou d’un acquéreur supportant la solution pour obtenir un contrat commerçant. Genius Checkout connecte ensuite ce compte Powertranz approuvé aux sites, logiciels, liens de paiement et API compatibles.

#Puis-je recevoir mes règlements sur un compte bancaire jamaïcain ?

Le règlement est régi par la banque ou le contrat d’acquisition ; vérifiez le type de compte, devises, frais, réserves et délais avec l’établissement avant le lancement.

#Powertranz fonctionne-t-il seulement avec WooCommerce ?

Non. Une passerelle Powertranz validée peut alimenter plusieurs intégrations Genius Checkout et canaux de paiement. Chaque plateforme doit toutefois tester sa redirection, ses webhooks, ses relances et la gestion des états de commande.

#Références officielles et prochaine étape

• Emplacements commerçants Powertranz et institutions participantes
• Passerelle de paiement Powertranz
• Powertranz Hosted Payment Page
• NCB eCommerce
• Présentation Genius Checkout Powertranz
• Guide de configuration Genius Checkout Powertranz

Créez un compte Genius Checkout ou planifiez une revue d’intégration muni de votre pack banque.