API Disbursements

L'API Disbursements vous permet de transférer des fonds de votre solde marchand AWDPay vers les portefeuilles mobiles de vos clients, partenaires, freelances ou sous-comptes internes.

Cas d'usage

• 💸 Remboursements clients — Rembourser un achat annulé
• 👷 Paiements prestataires — Payer les livreurs, chauffeurs, freelances
• 🎁 Cashback & récompenses — Distribuer des gains, bonus ou promotions
• 🏢 Transferts internes — Financer les sous-comptes ou filiales
• 📤 Transferts en masse — Payer les salaires ou commissions par lot

Navigation rapide

Fonctionnalités principales

Fonctionnalité	Description
Créer un retrait	Initier un disbursement vers un bénéficiaire
Vérifier le statut	Suivre le statut de retrait en temps réel
Liste des retraits	Consulter l'historique paginé des disbursements
Statistiques	Accéder aux métriques agrégées
Webhooks	Recevoir des notifications en temps réel

Pays & passerelles supportés

Pays	Fournisseurs	Noms de passerelles	Types
🇸🇳 Sénégal	Wave, Orange Money	wave-senegal, orange-money-sn	REDIRECT, OTP
🇨🇮 Côte d'Ivoire	Orange Money, MTN, Wave, Moov	orange-money-ci, mtn-ci, wave-ci, moov-ci	OTP, DIRECT, REDIRECT
🇧🇯 Bénin	Moov	moov-benin	DIRECT
🇲🇱 Mali	Orange Money, Moov	orange-money-mali, moov-mali	DIRECT
🇧🇫 Burkina Faso	Orange Money	orange-money-burkina	OTP
🇨🇲 Cameroun	MTN	mtn-cm	DIRECT

Passerelles dynamiques

Récupérez la liste exacte des passerelles activées avec GET /api/gateways?flow=disbursement

Meilleures pratiques

Idempotence

Utilisez des clés d'idempotence pour éviter les double-disbursements lors des nouvelles tentatives :

curl -X POST "https://app.awdpay.com/api/withdraws/initiate" \
  -H "Authorization: Bearer $AWDPAY_TOKEN" \
  -H "Idempotency-Key: payout-8831-attempt-1" \
  -H "Content-Type: application/json" \
  -d '{...}'

Limites de taux

• Respectez les limites opérateur (par transaction, quotidiennes, hebdomadaires)
• AWDPay retourne limit_exceeded si une limite est atteinte
• Vérifiez les limites via GET /api/gateways?flow=disbursement

Méthodes OTP

Pour les passerelles OTP (ex. Orange Money SN) :

1. Le bénéficiaire reçoit un OTP sur son téléphone
2. Il doit confirmer le code pour finaliser le transfert
3. Le statut passe de pending → processing → success

Audit & rapprochement

• Conservez toujours la reference AWDPay et votre orderReference
• Utilisez metadata pour stocker vos identifiants internes
• Exportez régulièrement vos transactions via le tableau de bord

---

Prochaines étapes

1. Authentification → Obtenir votre token API
2. Environnements → Tester en sandbox
3. Gestion des erreurs → Gérer les cas d'échec
4. Collections → Accepter aussi les paiements entrants