DolaPay Developers

Décaissements (Payouts)

Utilisez l'API de Décaissement pour envoyer de l'argent instantanément vers un compte Mobile Money. Parfait pour payer vos partenaires, vos livreurs, ou pour permettre à vos utilisateurs de retirer leurs gains.

Processus Asynchrone

Comme pour les paiements entrants, les décaissements sont traités de manière asynchrone. L'API retourne un statut processing. Le montant (frais inclus) sera réservé sur votre solde DolaPay. Vous devez écouter les Webhooks pour savoir quand le décaissement passe en success (ou s'il échoue, auquel cas les fonds vous seront restitués).

Initier un Décaissement

POST/api/v1/payouts

Paramètres du Body (JSON)

Paramètre	Description
amount *	Le montant à envoyer (ex: `5000`). Toujours un entier strictement positif. Minimum 200 FCFA.
currency *	La devise cible. `XOF`, `XAF`. Par défaut, `XOF`.
recipient_phone *	Le numéro de téléphone du destinataire, avec l'indicatif du pays (ex: `22900000000`).
provider *	L'opérateur mobile du destinataire. Exemples: `Orange`, `MTN`, `MOOV`, `Telecel`, `Wallet` (LigdiCash), `Airtel`, `Free`. Par défaut, `Orange`.
reference	Une référence interne optionnelle (ex: nom de votre partenaire ou motif du décaissement) pour vos réconciliations comptables.

javascript

const response = await fetch("https://api.dola-pay.com/v1/payouts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_votre_cle_secrete",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    amount: 5000,
    currency: "XOF",
    provider: "MTN",
    recipient_phone: "22900000000",
    reference: "Retrait_Commissions_Janvier"
  })
});
const data = await response.json();
console.log(data.status); // Statut initial: "processing"