Paiements

Payouts

Envoyez des fonds depuis votre solde WanePay vers un beneficiaire mobile money.

Endpoints

POST/v1/payoutsCreer un payoutcle secrete

GET/v1/payoutsLister les payoutscle publique ou secrete

GET/v1/payouts/:idRecuperer un payoutcle publique ou secrete

Creer un payout

curl https://api.wanepay.com/v1/payouts \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout-123" \
  -d '{
    "amount": 5000,
    "currency": "XOF",
    "country": "TG",
    "payment_method": "mobile_money",
    "network": "flooz",
    "recipient": { "name": "Kossi Adjo", "phone": "+22890000000" },
    "reference": "PAYOUT-123"
  }'

Reservation des fonds

Un payout debite immediatement votre solde disponible, frais compris. Les ecritures sont posees a la creation :

merchant_available   debit    5 000    (montant du payout)
payout_settlement    credit   5 000
merchant_available   debit       50    (commission)
platform_revenue     credit      50

Si la connexion echoue, WanePay ne supprime aucune ecriture : il en ecrit l’inverse (contrepassation) et votre solde est restitue a l’identique.

Un payout dont le montant depasse le solde disponible est refuse avec insufficient_funds_error. En sandbox, creditez votre solde de test depuis le dashboard ou via POST /v1/sandbox/fund.

Parametres

Parametre	Type	Description
`amount`requis	integer	Montant en unite minimale.
`currency`requis	string	Devise du payout.
`country`requis	string	Pays du beneficiaire.
`payment_method`requis	string	Actuellement mobile_money pour les connexions disponibles.
`network`	string	Reseau precis souhaite.
`recipient`requis	object	name, phone, email ou account — au moins un identifiant.
`reference`	string	Votre reference interne.
`metadata`	object	Cles libres.

Statuts

Statut	Signification
`pending`	En attente — Fonds reserves, transmis a la connexion.
`processing`	En cours — Le reseau execute le transfert.
`succeeded`	Reussi — Le beneficiaire a ete credite.
`failed`	Echoue — Transfert refuse — les fonds sont restitues.
`cancelled`	Annule — Annulation avant execution.