Développeurs

Faites circuler l’argent en quelques lignes de code.

Une API REST prévisible, des SDK typés, un serveur MCP et un bac à sable qui se comporte comme la production, pour l’encaissement, les paiements et les cartes dans 14 pays d’Afrique.

{{ cur.file }}{{ cur.lang }}
{{ cur.code }}
Référence de l’API

Un modèle cohérent pour chaque produit

Référence complète de l’API

{{ r.t }}

{{ r.p }}

{{ r.d }}

{{ e.m }}{{ e.p }}
Serveur MCP

Un portefeuille sous contrôle pour tout assistant

L’assistant ne voit jamais vos clés de production ni votre solde. Il n’obtient que ce que la politique de l’agent autorise.

{{ l.alt }}
{{ m.n }}
{{ m.d }}
Bac à sable

Testez chaque scénario avant la mise en production

Avec une clé sk_test_ , des valeurs spéciales déclenchent des résultats précis. Aucune vraie carte n’est émise et aucun fonds réel ne circule.

{{ s.a }}{{ s.r }}
Erreurs

Des erreurs exploitables par les humains comme par les agents

Chaque refus renvoie un code stable et un message lisible : votre code ou votre agent sait s’il doit réessayer, demander moins ou s’arrêter.

{{ errCode }}
{{ p.k }}

{{ p.t }}

{{ p.d }}

Obtenez vos clés de test

Le bac à sable est gratuit et s’ouvre avec des soldes de test en XAF, XOF, NGN, KES et USD.

Ouvrir un compteLire la documentation
Développeurs

Faites circuler l’argent en quelques lignes de code.

Une API REST prévisible, des SDK typés, un serveur MCP et un bac à sable qui se comporte comme la production, pour l’encaissement, les paiements et les cartes dans 14 pays d’Afrique.

terminalbash
# Node.js
npm install @monerail/node

# Python
pip install monerail

# MCP server (Claude, Cursor…)
npx -y @monerail/mcp

# Environment
export MONERAIL_API_KEY=sk_test_••••
Référence de l’API

Un modèle cohérent pour chaque produit

Référence complète de l’API

Liens de paiement

Encaissement

Liens partageables et pages de paiement hébergées.

POST/v1/payment_links
GET/v1/payment_links/:id
PATCH/v1/payment_links/:id

Encaissements

Encaissement

Paiements mobile money, avec remboursements.

POST/v1/collections
GET/v1/collections/:id
POST/v1/collections/:id/refund

Paiements sortants

Paiements sortants

Paiements unitaires et en lot vers les portefeuilles mobile money et les comptes bancaires.

POST/v1/payouts
POST/v1/payout_batches
GET/v1/payouts/:id

Bénéficiaires

Paiements sortants

Bénéficiaires mobile money et bancaires vérifiés.

POST/v1/recipients
GET/v1/recipients/:id
DELETE/v1/recipients/:id

Cartes

Cartes

Émettez, alimentez, gelez, affichez et clôturez n’importe quelle carte.

POST/v1/cards
POST/v1/cards/:id/fund
DELETE/v1/cards/:id

Titulaires

Cartes

Collaborateurs et clients, avec leurs vérifications d’identité.

POST/v1/cardholders
GET/v1/cardholders/:id
POST/v1/cardholders/:id/kyc_link

Agents et politiques

Cartes pour agents

Identités des agents, plafonds, commerçants et seuils de validation.

POST/v1/agents
POST/v1/policies
POST/v1/agents/:id/freeze

Demandes de dépense

Cartes pour agents

L’agent demande ; la politique ou une personne décide.

POST/v1/spend_requests
POST/v1/spend_requests/:id/approve
POST/v1/spend_requests/:id/decline

Transactions et événements

Commun

Un registre pour chaque mouvement, et des webhooks signés relancés pendant 72 heures.

GET/v1/transactions
POST/v1/webhook_endpoints
POST/v1/events/:id/replay
Serveur MCP

Un portefeuille sous contrôle pour tout assistant

L’assistant ne voit jamais vos clés de production ni votre solde. Il n’obtient que ce que la politique de l’agent autorise.

ClaudeChatGPTCursor
request_payment
Demander un montant chez un commerçant, avec un motif.
get_card
Récupérer la carte validée pour finaliser un paiement.
get_budget
Indiquer à l’agent ce qu’il lui reste à dépenser.
list_payments
Lister les paiements récents de l’agent.
cancel_request
Annuler une demande devenue inutile.
Bac à sable

Testez chaque scénario avant la mise en production

Avec une clé sk_test_ , des valeurs spéciales déclenchent des résultats précis. Aucune vraie carte n’est émise et aucun fonds réel ne circule.

phone: +254 700 000 001Le paiement mobile money réussit
iban: DE00 TEST 0000 0002Paiement retourné : compte clôturé
amount: 4242Le paiement par carte exige le 3-D Secure
$1.00 – $250.00Demande de l’agent validée
$250.01 – $499.99Demande de l’agent en attente de validation
$666.00Refusé : commerçant bloqué
Erreurs

Des erreurs exploitables par les humains comme par les agents

Chaque refus renvoie un code stable et un message lisible : votre code ou votre agent sait s’il doit réessayer, demander moins ou s’arrêter.

HTTP 402
{
  "error": {
    "code": "limit_exceeded",
    "message": "The amount exceeds this agent's
                daily limit.",
    "remaining_today": 1850,
    "retry": "reduce_amount"
  }
}
idempotency

Requêtes idempotentes

Réessayez sans risque avec une Idempotency-Key, sans jamais débiter, payer ou émettre deux fois.

versioning

Versions datées

Votre intégration reste figée sur la version choisie.

test / live

Clés séparées

Des clés de test et de production distinctes, révocables à tout moment.

scopes

Clés restreintes

Une clé par service ou par agent, limitée aux actions nécessaires.

Obtenez vos clés de test

Le bac à sable est gratuit et s’ouvre avec des soldes de test en XAF, XOF, NGN, KES et USD.