Comment verser de l'argent à mes utilisateurs par MonCash (paiements sortants) ?

L'API MonCash propose des opérations de transfert vers un numéro MonCash (endpoint de type /v1/Transfert), ainsi que la consultation du solde prépayé du marchand. Mais ces fonctions ne sont pas activées par défaut : il faut un accord spécifique avec Digicel et un compte marchand qualifié pour les paiements sortants. Contactez leur service business, et vérifiez le contrat et les limites avant de concevoir votre produit autour.

Si vous obtenez l'accès, traitez les paiements sortants comme l'opération la plus dangereuse de votre système :

1. Jamais déclenchés directement par une action utilisateur. Une file de « versements à effectuer », approuvée par un humain ou par des règles strictes (plafond par livreur et par jour).
2. Idempotence : chaque versement a une reference unique stockée avant l'appel. En cas de timeout, on vérifie le statut avant de réessayer, sinon on risque de payer deux fois.
3. Numéro vérifié : le numéro MonCash du livreur est confirmé une fois (petit versement test ou validation humaine), puis tout changement de numéro déclenche une nouvelle vérification et un délai. C'est le scénario de fraude classique.
4. Droits séparés : le compte qui prépare les versements n'est pas celui qui les approuve.
5. Journal d'audit complet : qui, quand, combien, vers quel numéro.

Sans accès à l'API de transfert, beaucoup de plateformes commencent par un export (liste des montants et numéros) que le responsable financier exécute manuellement depuis le compte business.