Solde et retraits
CajouPay est un établissement de monnaie électronique : un paiement réussi crédite votre compte CajouPay de son montant net, disponible tout de suite.
Solde
GET /v1/balance renvoie available (disponible au retrait, frais déduits) et pending_payout
(réservé par des retraits en cours).
GET /v1/balance_transactions liste les mouvements du compte, du plus récent au plus ancien :
type | Mouvement |
|---|---|
payment | crédit d'un paiement réussi (montant brut) |
fee | frais CajouPay du paiement (négatif) |
payout | retrait vers votre compte de retrait (négatif) |
payout_reversal | recrédit d'un retrait échoué |
adjustment | correction validée par CajouPay |
Chaque mouvement porte source_id, le paiement (pay_…) ou le retrait (po_…) d'origine. Un
paiement en double n'y apparaît jamais : il est remboursé au client.
Retraits
Par défaut, tout le solde est retiré chaque jour à 6 h (heure d'Abidjan) vers votre compte de retrait (compte bancaire ou alias), que vous enregistrez dans le tableau de bord.
Vous pouvez aussi retirer à la demande : POST /v1/payouts, avec amount ou sans (tout le solde
disponible), et un en-tête Idempotency-Key. Le montant est réservé aussitôt, puis :
paid: versé sur votre compte de retrait (webhookpayout.paid) ;failed: le virement a échoué, le montant revient sur votre solde (failure_code, webhookpayout.failed).
En production, sans compte de retrait vérifié, la création répond 403 payout_account_missing.