Payments
Virements
Lancez des virements sortants mobile money avec un corps spécifique au prestataire.
Les virements initiés marchands sur les rails pris en charge sont exposés en POST avec un corps propre au prestataire. Il n’y a pas de liste REST publique générique (GET /payouts) dans le contrat marchand suivre l’état via les webhooks.
Le traitement est asynchrone. Écoutez les webhooks (payout.completed, payout.failed, …) au lieu de poller une liste REST qui n’est pas exposée dans le périmètre public actuel.
Cycle de vie, limites et frais : cycle de vie des virements.
Lancer un virement Wave
Expose POST /payout/wave (montant, devise, bénéficiaire imbriqué).
import { LomiSDK } from '@lomi./sdk';
const lomi = new LomiSDK({
apiKey: process.env.LOMI_API_KEY!,
environment: 'live',
});
await lomi.payouts.createWavePayout({
amount: 25000,
currency: 'XOF',
beneficiary: {
name: 'Aicha Diallo',
phoneNumber: '+221771234567',
},
reason: 'Règlement hebdomadaire',
});import requests, os
r = requests.post(
"https://api.lomi.africa/payout/wave",
headers={"X-API-KEY": os.environ["LOMI_API_KEY"], "Content-Type": "application/json"},
json={
"amount": 25000,
"currency": "XOF",
"beneficiary": {"name": "Aicha Diallo", "phoneNumber": "+221771234567"},
"reason": "Règlement hebdomadaire",
},
)
print(r.status_code, r.json())curl -X POST "https://api.lomi.africa/payout/wave" \
-H "X-API-KEY: $LOMI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 25000,
"currency": "XOF",
"beneficiary": { "name": "Aicha Diallo", "phoneNumber": "+221771234567" },
"reason": "Règlement hebdomadaire"
}'Champs (virement Wave)
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
amount | number | Oui | Montant |
currency | string | Oui | Devise |
beneficiary | object | Oui | name et phoneNumber |
reason | string | Non | Motif / audit |