Aller au contenu
LevaPay

L’API MonCash pour envoyer de l’argent vers les portefeuilles en Haïti

Connectez votre app de transfert d’argent, de paiements ou fintech à MonCash avec une API REST simple : devis, envoi et suivi de chaque transfert jusqu’à ce que l’argent arrive sur le portefeuille du bénéficiaire.

  • Sandbox TEST gratuit
  • 3,5 % par transfert, sans abonnement
  • La même API fonctionne pour NatCash

Qu’est-ce que l’API MonCash de LevaPay ?

MonCash est le portefeuille mobile le plus utilisé en Haïti : des millions de personnes y reçoivent et y gardent leur argent sur leur téléphone. L’API MonCash de LevaPay permet à votre plateforme d’envoyer des gourdes (HTG) vers n’importe quel portefeuille MonCash avec seulement le numéro de téléphone haïtien du bénéficiaire.

Au lieu de construire et de maintenir une connexion distincte avec chaque réseau, votre système communique avec une seule API REST. Vous demandez un devis, vous voyez le total exact qui sera débité de votre solde prépayé, vous confirmez le transfert et vous consultez son statut. LevaPay se charge de livrer l’argent sur le portefeuille.

Elle est conçue pour les entreprises qui envoient de l’argent en Haïti : apps de transfert depuis la République dominicaine, les États-Unis ou ailleurs, portefeuilles numériques, plateformes de paiements P2P et entreprises qui paient des collaborateurs ou des fournisseurs haïtiens.

MonCash est une marque de Digicel Haïti et NatCash est une marque de Natcom. LevaPay est un service indépendant. L’API LevaPay sert à envoyer de l’argent (paiements sortants) vers les portefeuilles MonCash. Ce n’est pas l’API marchande de Digicel pour encaisser des paiements dans une boutique en ligne.

API REST pour Haïti

Comment envoyer de l’argent vers MonCash avec l’API

  1. 1

    Créez votre compte et vos clés TEST

    Inscrivez-vous gratuitement et générez dans le panneau un utilisateur API et une PRIVATE_KEY de test. Le sandbox ne déplace jamais d’argent réel.

    Gratuit
  2. 2

    Demandez un devis

    Appelez POST /transfers/quote avec network "moncash", le numéro et le montant en HTG. Vous recevez la commission, le total et un quote_id valable environ 120 secondes.

    POST /transfers/quote
  3. 3

    Confirmez le transfert

    Envoyez le quote_id à POST /transfers avec une idempotency_key unique. Si votre système réessaie, vous n’êtes jamais débité deux fois.

    POST /transfers
  4. 4

    Suivez le statut

    MonCash peut répondre pending pendant la confirmation du dépôt. Appelez GET /transfers/{id} jusqu’au statut completed ou failed.

    GET /transfers/{id}
API MonCash

Exemple : envoyer 5 000 HTG vers un portefeuille MonCash

Devis, envoi et suivi du statut avec l’API MonCash en mode TEST. Pour utiliser de l’argent réel, remplacez /test/v1 par /prod/v1 et utilisez vos clés PROD.

  • Authentification avec les en-têtes X-Api-User et X-Api-Key
  • Réponses JSON avec ok, data et message
  • Suivi du statut jusqu’à completed ou failed
  • Jusqu’à 60 requêtes par minute et par clé
Voir la documentation
# 1) Devis
curl -X POST https://api.levapay.dev/test/v1/transfers/quote \
  -H "Content-Type: application/json" \
  -H "X-Api-User: votre_utilisateur_api" \
  -H "X-Api-Key: votre_PRIVATE_KEY" \
  -d '{"network":"moncash","wallet":"50937123456","amount_htg":5000}'

# 2) Envoyer
curl -X POST https://api.levapay.dev/test/v1/transfers \
  -H "Content-Type: application/json" \
  -H "X-Api-User: votre_utilisateur_api" \
  -H "X-Api-Key: votre_PRIVATE_KEY" \
  -d '{"quote_id":"qt_...","idempotency_key":"commande-10025"}'

# 3) Consulter le statut (pending → completed)
curl https://api.levapay.dev/test/v1/transfers/tr_... \
  -H "X-Api-User: votre_utilisateur_api" \
  -H "X-Api-Key: votre_PRIVATE_KEY"

Ce qu’il faut savoir sur les transferts MonCash

Numéro du portefeuille

Utilisez le numéro de téléphone haïtien associé à MonCash : 8 chiffres, avec ou sans le préfixe 509 (par exemple 37123456 ou 50937123456). Les montants sont en gourdes, entiers, à partir de 1 HTG.

Statuts pending, completed et failed

Un transfert MonCash peut rester quelques instants en pending pendant la confirmation du dépôt. Votre intégration doit consulter le statut et afficher le résultat final au client. Si le transfert échoue, le montant revient sur votre solde.

Titulaire du portefeuille

La vérification du nom du titulaire avant l’envoi est disponible pour NatCash, pas pour MonCash. Demandez donc à l’expéditeur de confirmer le numéro dans votre app avant d’appeler l’API.

Mode TEST

Dans le sandbox, les transferts MonCash restent en pending et le montant est réservé sur votre solde TEST. Vous pouvez ainsi tester la gestion d’un transfert qui n’est pas encore terminé.

Note pour le bénéficiaire

Le champ note (64 caractères maximum) définit le texte que le bénéficiaire verra sur son dépôt, par exemple le nom de votre app ou un numéro de commande.

Pourquoi utiliser LevaPay pour vos transferts MonCash

Total exact avant l’envoi

Le devis indique le montant, la commission et le total : votre client sait ce que recevra le bénéficiaire.

Aucun double débit

L’idempotency_key obligatoire fait qu’une nouvelle tentative renvoie le même transfert au lieu d’en créer un autre.

Débit seulement si accepté

Votre solde prépayé n’est débité que lorsque le transfert est accepté.

MonCash et NatCash ensemble

Le même code fonctionne pour les deux réseaux : seule la valeur de network change.

Sandbox gratuit

Des clés TEST pour développer et tester sans argent réel.

Panneau pour votre entreprise

Solde, historique des transferts, approvisionnement et clés API au même endroit.

Tarif de l’API MonCash

Vous payez 3,5 % du montant de chaque transfert, sans frais d’ouverture, sans abonnement et sans frais d’approvisionnement. Votre solde prépayé en HTG s’approvisionne par virement Banreservas, USDT ou Binance Pay. Par exemple, pour que le bénéficiaire reçoive 5 000 HTG sur MonCash :

Le bénéficiaire reçoit
5,000.00 HTG
Commission (3,5 %)
175.00 HTG
Total débité de votre solde
5,175.00 HTG

Voir les tarifs et les moyens d’approvisionnement

Questions fréquentes

Est-ce l’API officielle de MonCash ?

Non. LevaPay est un service indépendant qui permet aux entreprises d’envoyer de l’argent vers les portefeuilles MonCash grâce à sa propre API. MonCash est une marque de Digicel Haïti.

Puis-je encaisser des paiements MonCash avec cette API ?

Non. L’API LevaPay sert à envoyer de l’argent vers les portefeuilles MonCash (paiements sortants). Encaisser des clients dans une boutique en ligne relève d’un bouton de paiement marchand, un produit différent.

Combien de temps prend un transfert MonCash ?

Il est généralement crédité rapidement, mais il peut rester quelques instants en pending. Appelez GET /transfers/{id} jusqu’au statut completed.

Que se passe-t-il si un transfert échoue ?

Si le transfert n’est pas accepté, votre solde n’est pas débité. S’il échoue après acceptation, le statut passe à failed et le montant revient sur votre solde.

Que faut-il pour passer en production ?

Demandez l’accès à la production depuis le panneau et complétez la vérification : informations du représentant, pièce d’identité et selfie. Le mode TEST est disponible dès l’inscription.

Avec quels langages intégrer l’API MonCash ?

Avec tout langage capable de faire des requêtes HTTPS : PHP, Node.js, Python, Java, Go ou C#. La documentation inclut des exemples en cURL, PHP et Node.js.

Puis-je aussi envoyer vers NatCash ?

Oui. Avec la même intégration, vous envoyez vers NatCash en indiquant network "natcash", et vous pouvez vérifier le titulaire avant l’envoi.

Commencez à envoyer vers MonCash dès aujourd’hui

Créez un compte gratuit, testez l’API MonCash en mode TEST et passez en production quand vous êtes prêt.