MonCash est aujourd'hui le porte-monnaie mobile le plus utilisé en Haïti. Pour toute entreprise qui vend en ligne ou via une application, la question revient vite : comment accepter MonCash directement dans son produit, sans faire vérifier chaque paiement à la main ? La réponse passe par l'API MonCash, et par la façon dont elle est intégrée.

Qu'est-ce que MonCash ?

MonCash est le service de porte-monnaie mobile de Digicel en Haïti. Il permet à des millions d'utilisateurs de recevoir, envoyer et dépenser des gourdes (HTG) directement depuis leur téléphone, sans compte bancaire traditionnel. Pour beaucoup de commerçants, particuliers et plateformes en ligne, MonCash est aujourd'hui le moyen de paiement par défaut.

Qu'est-ce que l'API MonCash ?

L'API MonCash est l'interface qui permet à une entreprise de connecter son site web ou son application directement à l'infrastructure MonCash, plutôt que de demander à ses clients d'envoyer un paiement manuellement puis de vérifier chaque transaction à la main. Concrètement, une intégration à l'API MonCash permet généralement de :

  • Générer une demande de paiement pour un montant précis, en gourdes ;
  • Rediriger ou notifier le client pour qu'il confirme le paiement depuis son compte MonCash ;
  • Recevoir une confirmation automatique une fois la transaction complétée ;
  • Distinguer un environnement de test (sandbox) d'un environnement de production.

Comme pour la plupart des API de paiement, l'accès se fait via des clés d'authentification, et chaque entreprise doit gérer ses propres identifiants, ses appels réseau et la fiabilité de ses notifications de confirmation.

Pourquoi l'intégrer directement peut être complexe

Sur le papier, connecter une API de paiement semble simple. En pratique, plusieurs points demandent une attention réelle lorsqu'on intègre MonCash directement :

  • Gestion des clés et de l'authentification. Les identifiants doivent être stockés et renouvelés correctement, sans jamais être exposés côté client.
  • Fiabilité des confirmations. Un paiement peut être confirmé en retard, en double, ou échouer silencieusement si les notifications ne sont pas traitées correctement.
  • Un seul moyen de paiement. MonCash ne couvre que les gourdes, donc toute entreprise qui veut aussi accepter des cartes internationales doit intégrer une deuxième infrastructure séparément.
  • Maintenance continue. Comme toute API externe, les changements côté fournisseur doivent être suivis et pris en charge dans le temps.

Les exigences de sécurité pour un paiement MonCash en ligne

Parce qu'il s'agit d'argent réel, une intégration MonCash sérieuse doit couvrir plusieurs aspects de sécurité, peu importe qui l'implémente :

  • Chiffrement de toutes les communications entre le client, le serveur et l'API de paiement ;
  • Vérification de l'authenticité de chaque notification de paiement reçue, pour éviter qu'une fausse confirmation ne soit acceptée ;
  • Traitement idempotent des transactions, pour qu'un même paiement ne soit jamais compté deux fois ;
  • Journalisation complète des opérations, pour pouvoir retracer et auditer chaque transaction ;
  • Stockage sécurisé des clés d'accès et des données sensibles.

Comment Tranzak simplifie et sécurise l'intégration MonCash

Plutôt que d'intégrer MonCash isolément, Tranzak propose une API unique qui couvre MonCash, les cartes bancaires et, à terme, d'autres méthodes de paiement. La sécurité (chiffrement, vérification des webhooks, journalisation) est gérée au niveau de la plateforme, pas à reconstruire par chaque entreprise. Un appel suffit pour créer un paiement MonCash :

create-payment.js
// Créer un paiement MonCash via l'API Tranzak
const response = await fetch('https://tranzak.mykaypa.com/api/gateway/v1/payments', {
  method: 'POST',
  headers: { 'X-API-Key': apiKey },
  body: JSON.stringify({
    amount: 500,
    currency: 'HTG',
    payment_method: 'moncash',
    customer_name: 'Jean Baptiste'
  })
});

Le reste (vérification de la confirmation, sécurité de la clé, conformité) est pris en charge par Tranzak, avec la même API que pour les autres méthodes de paiement.

Comment démarrer

Intégrer MonCash via Tranzak se fait en trois étapes :

  • Créez vos clés API. Une clé de test et une clé de production, depuis votre tableau de bord.
  • Intégrez en sandbox. Testez vos paiements MonCash sans risque avant la mise en ligne.
  • Passez en production. Activez vos clés live et suivez vos transactions en temps réel.

Questions fréquentes

MonCash a-t-il une API pour les entreprises ?

Oui, MonCash propose une API destinée aux entreprises pour accepter des paiements directement dans leurs produits, en plus des paiements manuels entre particuliers.

Faut-il un compte marchand MonCash séparé pour utiliser Tranzak ?

Non. Vous créez un compte Tranzak, et l'acceptation MonCash est activée directement depuis votre tableau de bord, sans démarche technique séparée auprès de MonCash.

Comment sont confirmés les paiements MonCash ?

Chaque paiement est confirmé automatiquement en temps réel, et le solde correspondant est crédité instantanément sur votre compte Tranzak.

Quels sont les frais pour accepter MonCash via Tranzak ?

4% par transaction, sans frais d'installation ni abonnement mensuel. Voir le détail sur la page tarifs.