Créer un virement

Aperçu

Créer un virement

Virement vers votre compte enregistré (self) ou vers un tiers sur mobile money / SPI (beneficiary).

Quand utiliser cet endpoint

Utilisez cet endpoint quand vous devez exécuter POST /payouts (Créer un virement).

Authentification

Les routes marchandes nécessitent une clé API dans l’en-tête X-API-KEY (voir Aperçu de l’intégration). Utilisez une clé test avec https://sandbox.api.lomi.africa et une clé live avec https://api.lomi.africa.

Point de terminaison

POST /payouts

URLs de base :

• https://sandbox.api.lomi.africa
• https://api.lomi.africa

Requête

Paramètres de chemin

Aucun paramètre de chemin au-delà du motif d’URL.

Paramètres de requête

Aucun paramètre de requête.

Corps de la requête

Aucun corps application/json pour cette opération.

Réponses

Erreurs

Les erreurs suivent le format JSON standard (code de statut et message lisible par machine). Validez les entrées avant appel ; 401 indique une clé manquante/invalide, 404 une ressource introuvable pour cette organisation, 429 une limitation de débit. Pour les retries sûrs sur les créations, envoyez une clé d’idempotence quand votre flux le permet.

Exemple

curl -sS -X POST "https://sandbox.api.lomi.africa/payouts" \
  -H "X-API-KEY: $LOMI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

OpenAPI

• operationId: PayoutsUnifiedController_create
• Operation: POST /payouts

Schémas complets et Try it : référence API. Contrat machine : openapi.json à la racine des docs.