Aller au contenu principal
Nouveau L'API d'émission de cartes v3 est disponible — créez des programmes de cartes en quelques minutes. Voir la documentation →
Développeurs
Connexion Commencer
API de versement

API de versement

Automatisez les décaissements vers les comptes bancaires et portefeuilles mobiles à travers l'Afrique. Envoyez des versements unitaires ou par milliers en un seul appel API.

Obtenir les clés API Voir la page Business

4.5/5 from 47,942 reviews

Envoyer un versement unitaire

Décaissez des fonds vers un portefeuille mobile money ou un compte bancaire en un seul appel API.

POST /v1/payouts
bash 
curl -X POST https://api.fyatu.com/v1/payouts \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "currency": "KES",
    "method": "mobile_money",
    "provider": "mpesa",
    "recipient": "+254712345678",
    "reference": "salary_jan_001"
  }'

Envoyer des versements par lots

Traitez des milliers de versements en une seule requête. Combinez virements bancaires et mobile money dans le même lot.

POST /v1/payouts/batch
bash 
curl -X POST https://api.fyatu.com/v1/payouts/batch \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "batch_reference": "payroll_feb_2026",
    "payouts": [
      {"amount": 50000, "currency": "NGN", "method": "bank_transfer", "bank_code": "044", "account_number": "0123456789"},
      {"amount": 35000, "currency": "NGN", "method": "bank_transfer", "bank_code": "058", "account_number": "9876543210"},
      {"amount": 8000, "currency": "KES", "method": "mobile_money", "provider": "mpesa", "recipient": "+254798765432"}
    ]
  }'

Notification webhook

Recevez des notifications en temps réel lorsque les versements sont complétés, échoués ou annulés.

Événement webhook : payout.completed
json 
// Webhook payload for completed payout
{
  "event": "payout.completed",
  "data": {
    "id": "pay_xyz789",
    "amount": 10000,
    "currency": "KES",
    "status": "completed",
    "reference": "salary_jan_001"
  }
}

Points de terminaison API

POST /v1/payouts
POST /v1/payouts/batch
GET /v1/payouts
GET /v1/payouts/:id
GET /v1/payouts/batch/:id
POST /v1/payouts/validate
GET /v1/payouts/providers

Capacités de l'API

Outils complets pour automatiser les décaissements à travers l'Afrique.

Versements unitaires et par lots

Envoyez des versements individuels ou par milliers en un seul appel API. Idéal pour la paie, les paiements fournisseurs et les remboursements.

Banque et Mobile Money

Décaissez vers les comptes bancaires et portefeuilles mobile money dans plus de 30 pays africains. Toutes les grandes banques et fournisseurs mobile money supportés.

Validation de compte

Vérifiez les coordonnées bancaires et les numéros de mobile avant d'envoyer les versements. Réduisez les échecs et améliorez les taux de livraison.

Requêtes idempotentes

Chaque demande de versement supporte les clés d'idempotence. Réessayez en toute sécurité sans risque de double décaissement.

Suivi en temps réel

Suivez le statut des versements de l'initiation à la finalisation. Interrogez l'API ou recevez des notifications webhook pour chaque changement de statut.

Conversion de devises

Conversion de change automatique à des taux compétitifs. Envoyez depuis votre devise de base et les destinataires reçoivent en devise locale.

Des questions ?

Questions fréquentes sur l'API de versement.

Un seul lot peut contenir jusqu'à 10 000 versements individuels. Pour des volumes plus importants, vous pouvez soumettre plusieurs lots séquentiellement. Les clients entreprise peuvent demander des limites plus élevées auprès de leur gestionnaire de compte.
Utilisez l'endpoint de validation de compte (POST /v1/payouts/validate) pour vérifier les coordonnées bancaires ou les numéros de mobile avant d'initier un versement. Cela vérifie l'existence du compte et retourne le nom du titulaire pour confirmation.
Vous pouvez envoyer des versements dans plus de 25 devises africaines dont KES, NGN, GHS, ZAR, TZS, UGX, CDF, XAF et XOF. L'API gère automatiquement la conversion de change si vous alimentez votre compte dans une autre devise.
Les versements échoués déclenchent une notification webhook avec la raison de l'échec. Les raisons courantes incluent des coordonnées invalides, un solde insuffisant ou une indisponibilité du fournisseur. Les fonds des versements échoués sont automatiquement retournés à votre solde pour réessayer.
Les montants minimums varient selon le pays et la méthode. En général, le minimum est l'équivalent de 0,50 USD. Il n'y a pas de limite maximale pour les comptes entreprise vérifiés, bien que des limites individuelles par fournisseur puissent s'appliquer.

Commencez à envoyer des versements dès aujourd'hui

Intégrez l'API de versement et automatisez vos décaissements en quelques minutes. Accès sandbox gratuit inclus.

Obtenir les clés API Lire la documentation complète