Virements
Retraits vers vos comptes enregistrés ou paiements bénéficiaires (`POST /payouts`).
Utilisez POST /payouts pour tous les virements sortants.
Envoyer des fonds vers soi ou un bénéficiaire
POST /payouts
En-tête X-API-KEY. Variable : LOMI_SECRET_KEY. Hôte sandbox : sandbox.api.lomi.africa.
Wave and MTN payouts need a live key. Test keys return 400 for mobile-money payouts.
curl -sS -X POST "https://api.lomi.africa/payouts" \
-H "X-API-Key: $LOMI_SECRET_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"destination": "self",
"rail": "wave",
"amount": 50000,
"currency_code": "XOF",
"payout_method_id": "550e8400-e29b-41d4-a716-446655440000"
}'Créer un payout depuis le code
lomi.payouts.create
new LomiSDK({ apiKey: process.env.LOMI_SECRET_KEY, environment: "sandbox" }).
await lomi.payouts.create({
destination: 'self',
rail: 'wave',
amount: 50000,
currency_code: 'XOF',
payout_method_id: '550e8400-e29b-41d4-a716-446655440000',
});Créer un payout depuis le terminal
lomi payouts create
lomi login, puis la CLI envoie X-API-KEY depuis la session.
lomi payouts create --destination self --rail wave \
--amount 50000 --currency XOF --payout-method-id 550e8400-e29b-41d4-a716-446655440000Créer un payout depuis un agent
lomi_payouts action=create
MCP hébergé sur https://mcp.lomi.africa/mcp. OAuth ou x-lomi-api-key.
{
"action": "create",
"idempotency_key": "payout_123",
"body": {
"destination": "self",
"rail": "wave",
"amount": 50000,
"currency_code": "XOF",
"payout_method_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
destination: "self": retrait vers un moyen de paiement enregistré (payout_method_idrequis). Rails :bank,spi,wave.destination: "beneficiary": paiement à un tiers sur mobile money (waveaujourd’hui).recipient.nameetrecipient.phonerequis (numéro libre ; sans lien avecpayout_method_id).
Les virements Wave (rail: "wave") exigent une clé API live (lomi_sk_live_…). Les clés test renvoient 400 pour les virements self et beneficiary Wave, aucun appel Wave réel.
Les virements MTN renvoient 400 jusqu’à prise en charge.
Créer un virement
await lomi.payouts.create({
destination: 'self',
rail: 'wave',
amount: 50000,
currency_code: 'XOF',
payout_method_id: '550e8400-e29b-41d4-a716-446655440000',
});curl -X POST "https://api.lomi.africa/payouts" \
-H "X-API-KEY: $LOMI_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"destination":"beneficiary","rail":"wave","amount":10000,"currency_code":"XOF","recipient":{"name":"Ada","phone":"+221771234567"}}'Référence du corps de requête
| Champ | Type | Requis |
|---|---|---|
destination | 'self' | 'beneficiary' | Oui |
rail | 'wave' | 'spi' | 'bank' | 'mtn' | Oui |
amount | number | Oui |
currency_code | string | Oui |
payout_method_id | UUID | Oui pour self ; requis pour beneficiary spi |
recipient | { name, phone } | Oui pour beneficiary wave |
reason | string | Non |
Lister et obtenir
GET /payouts, retraits et virements bénéficiaires (kind). Les clés test ne listent que les retraits test ; les bénéficiaires live sont exclus.GET /payouts/{id}, retrait marchand ou bénéficiaire, limité à l’organisation de la clé.
Retrait bloqué par les contrôles de risque plateforme
Les retraits importants ou très fréquents peuvent être retenus automatiquement. En cas d’erreur liée au risque sur POST /payouts, réessayez plus tard ou contactez le support.
Pour l’analyse des risques sur les paiements entrants (carte et mobile money), voir lomi. Radar.