Virements

Utilisez POST /payouts pour tous les virements sortants.

• destination: "self": retrait vers un moyen de paiement enregistré (payout_method_id requis). Rails : bank, spi, wave.
• destination: "beneficiary": paiement à un tiers sur mobile money (wave aujourd’hui). recipient.name et recipient.phone requis (numéro libre ; sans lien avec payout_method_id).

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

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.