Paiements

Envoyez de l’argent vers des portefeuilles mobile money et des comptes bancaires.

Un paiement envoie de l’argent de votre solde vers quelqu’un d’autre : un fournisseur, un salarié, un client. Le mobile money et le virement bancaire utilisent le même point d’accès, dans toutes les devises de Montants et devises, NGN compris.

Mobile money#

curl https://api.monerail.com/v1/payouts \
  -H "Authorization: Bearer $MONERAIL_KEY" \
  -H "Idempotency-Key: payout-inv-118" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150000,
    "currency": "XAF",
    "recipient": { "type": "mobile_money", "name": "Kossi Mensah", "phone": "237670000777", "operator": "MTN" },
    "client_reference": "inv_118"
  }'

Virement bancaire#

Trouvez la banque avec Lister les banques et envoyez son code exactement tel que renvoyé. Un nom de banque ou un code qui ne correspond pas exactement échoue avec 400 bank_account_invalid.

{
  "amount": 150000,
  "currency": "XAF",
  "recipient": { "type": "bank", "name": "Kossi Mensah", "bank_code": "10005", "account": "10005000100123456784821" }
}

Les numéros de compte sont masqués dans toutes les réponses (••••4821).

Argent et statuts#

À la création d’un paiement, Monerail réserve amount + fee sur votre solde. S’il ne couvre pas les deux, la requête échoue avec 402 balance_insufficient et rien n’est envoyé.

La réservation apparaît dans les transactions comme un payout au statut pending, puis succeeded, ou failed accompagné d’un payout_reversal qui rend l’argent.

Sécurité#

• Envoyez toujours une Idempotency-Key. C’est la seule protection contre un double paiement après une erreur réseau.
• Les paiements demandent une clé créée par un membre Propriétaire, Finance ou Valideur.
• Une réponse 202 signifie que le partenaire de paiement n’a pas encore accusé réception. Ne recréez pas le paiement : attendez le webhook, ou consultez-le.