Comment relier votre logiciel à une passerelle de paiement en Arabie saoudite : Moyasar, Tap ou HyperPay ?

Relier votre logiciel ou votre boutique en ligne à une passerelle de paiement en Arabie saoudite se fait en sept étapes : ouvrir un compte marchand avec un registre du commerce ou une licence de travailleur indépendant et un compte bancaire saoudien, obtenir les clés de test, choisir le mode d'intégration (extension prête, formulaire hébergé ou API), indiquer les montants en halalas, confirmer chaque paiement depuis votre serveur, tester avec des cartes de test, puis passer aux clés de production. Moyasar, Tap et HyperPay acceptent toutes mada et Apple Pay ; elles diffèrent par les moyens de paiement, les pays, les outils et le délai de versement. Ni Moyasar ni HyperPay n'affichent de prix fixe.

D'abord : vérifier que la passerelle est agréée par la SAMA

La Banque centrale saoudienne agrée les prestataires de services de paiement selon le règlement d'application de la loi sur les paiements et les services de paiement, publié le 13 juin 2023. Selon l'annonce de la SAMA du 22 juillet 2026, 33 sociétés étaient agréées pour fournir des services de paiement. Les trois passerelles de ce guide sont agréées :

• Moyasar : agréée par la SAMA le 1er mars 2022 pour les paiements du commerce électronique, 16e société agréée (annonce de la SAMA).
• HyperPay : la société indique que la SAMA lui a accordé un agrément pour des solutions de portefeuille électronique, portant alors le nombre de sociétés agréées à 27 (annonce d'HyperPay).
• Tap : le communiqué de la société indique qu'elle détient un agrément d'établissement de paiement de la SAMA et que mada a certifié la technologie de sa passerelle (communiqué de Tap).

Quelle que soit la passerelle choisie, cherchez son nom sur le site de la SAMA avant de signer : la banque centrale demande elle-même de ne traiter qu'avec des prestataires agréés.

Comparatif complet : Moyasar, Tap et HyperPay

Ce comparatif repose sur les pages officielles et la documentation développeur de chaque société, telles qu'elles se présentaient le 2 novembre 2026 :

Sources : FAQ de Moyasar et documentation de Moyasar, documentation développeur de Tap et page de versement du support de Tap, site d'HyperPay, sa FAQ et son guide d'intégration.

Quelle passerelle pour votre logiciel ?

• Vous vendez uniquement en Arabie saoudite et voulez démarrer vite : Moyasar se concentre sur le Royaume, documente en arabe et en anglais, et son formulaire tient en quelques lignes de code.
• Vous vendez dans le Golfe ou voulez le paiement fractionné : la documentation de Tap couvre KNET et Benefit, ainsi que Tabby, Tamara et Deema par la même passerelle.
• Une grande entreprise ou présente dans plusieurs pays arabes : HyperPay opère dans 8 pays et propose la préautorisation mada, utile aux hôtels et loueurs de voitures qui bloquent un montant puis l'encaissent plus tard.
• Une plateforme ou place de marché avec de nombreux vendeurs : les trois proposent un outil de répartition des fonds ; comparez-les dans le même devis.

Ne choisissez pas sur le prix seul. Demandez par écrit à chaque société le taux mada, le taux des cartes de crédit, les frais fixes par transaction, les frais de remboursement et le délai de règlement, puis appliquez-les à un mois réel de vos ventes.

Guide d'intégration étape par étape

1. Ouvrez un compte marchand. Moyasar demande un registre du commerce ou une licence d'indépendant et un compte bancaire saoudien qui y est lié, et examine la boutique elle-même : produits, images, prix et politiques. La validation prend en général 2 à 5 jours ouvrés une fois le dossier complet.
2. Obtenez les clés de test. Les trois offrent un environnement de test. Chez Tap, les clés se trouvent dans le tableau de bord sous API credentials, et les applications mobiles reçoivent des clés liées à l'identifiant de l'application iOS ou Android. Gardez la clé secrète sur votre serveur uniquement, jamais dans l'application ni la page web.
3. Choisissez le mode d'intégration. Si votre boutique tourne sous WooCommerce ou Magento, l'extension est la voie la plus rapide. Pour un logiciel sur mesure, commencez par un formulaire hébergé : le formulaire de Moyasar ou COPYandPAY d'HyperPay. Ces formulaires envoient les données de carte directement à la passerelle ; elles ne passent pas par votre serveur et votre charge PCI DSS diminue. L'intégration serveur à serveur donne plus de contrôle, mais plus de responsabilité de sécurité.
4. Indiquez les montants en halalas. Chez Moyasar, 10 SAR s'écrivent 1000 et le minimum est de 100 halalas. Une erreur dans ce champ fait payer au client cent fois trop, ou un centième du prix.
5. Confirmez le paiement depuis votre serveur. Ne marquez pas une commande payée parce que le client est revenu sur la page de succès : cette adresse peut être falsifiée. Interrogez le statut du paiement depuis votre serveur et recevez le webhook. La documentation d'HyperPay prévient que le webhook peut, rarement, arriver avec plusieurs minutes de retard ; interrogez alors le statut directement. Liez chaque tentative à un seul numéro de commande pour qu'une nouvelle tentative ne débite pas deux fois. Chez HyperPay, une session de paiement expire au plus tard après 30 minutes.
6. Testez l'échec avant le succès. Les cartes de test de Moyasar comptent 8 cartes mada : une réussit et 7 échouent pour des raisons différentes, comme un solde insuffisant, une carte expirée ou volée. Vérifiez que votre logiciel affiche un message clair pour chaque cas, libère la réservation ou remet l'article en stock, puis testez les remboursements total et partiel.
7. Passez en production. Changez les clés, payez vous-même une petite transaction réelle, remboursez-la et surveillez la première semaine : le taux de réussite et la date d'arrivée des fonds sur votre compte.

Les erreurs qui coûtent de l'argent

• Stocker les données de carte dans votre base. Vous n'en avez pas besoin ; la passerelle conserve un jeton pour les paiements récurrents.
• Attendre les fonds le jour même. Chez Tap, les fonds mada arrivent sous 3 jours ouvrés et les cartes sous 5 : planifiez votre trésorerie en conséquence.
• Oublier le parcours de remboursement. Chez Moyasar, le client attend de 7 à 14 jours ouvrés un remboursement sur carte de crédit ; prévenez-le, sinon il risque d'ouvrir un litige auprès de sa banque.
• Une page de paiement trop longue. Chaque champ en trop fait perdre un acheteur ; notre guide de la page de paiement montre comment réduire l'abandon de panier.

Pour les bases, lisez l'intégration de mada, Apple Pay et STC Pay dans votre application. Si vous tenez un commerce et pensez encaisser avec un téléphone, lisez ce que nous savons de Tap to Pay en Arabie saoudite. Chez Origami, nous relions les logiciels et boutiques des entreprises aux passerelles de paiement et testons l'intégration avant le lancement ; contactez-nous si vous voulez nous la confier.