lomi.

Virements

Retraits vers vos comptes enregistrés ou paiements bénéficiaires (`POST /payouts`).

Utilisez POST /payouts pour tous les virements sortants.

Tableau de bord reversements à remplacer

  • 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).

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_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"beneficiary","rail":"wave","amount":10000,"currency_code":"XOF","recipient":{"name":"Ada","phone":"+221771234567"}}'

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é.

Sur cette page