Versements

Un versement (payout) envoie de l’argent de votre solde disponible vers un portefeuille mobile money : remboursement hors paiement, paiement d’un fournisseur, retrait. Il n’est possible que si votre contrat avec le fournisseur l’autorise.

POST/v1/payouts

Permission payouts:write. En-tête Idempotency-Key obligatoire.

Paramètre	Type	Description
`amount`requis	entier	Montant versé au bénéficiaire, en F CFA.
`currency`requis	"XOF"	Seule devise acceptée.
`provider`requis	"WAVE" \| "SANDBOX"	Fournisseur du portefeuille du bénéficiaire.
`recipient.mobile`requis	chaîne	Numéro au format international (+221…).
`recipient.name`facultatif	chaîne ≤ 120	Nom du bénéficiaire.
`reason`facultatif	chaîne ≤ 40	Motif court.

cURL

curl -sX POST https://backend.v1.pay.galsen.tech/v1/payouts \
  -H "Authorization: Bearer $GALSEN_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 15000,
    "currency": "XOF",
    "provider": "SANDBOX",
    "recipient": { "mobile": "+221771234567", "name": "Moussa Fall" },
    "reason": "Commission octobre"
  }'

Contrôles

Le montant et ses frais sont réservés sur le solde disponible : 422 INSUFFICIENT_BALANCE s’il ne suffit pas.
Vos plafonds s’appliquent (422 PAYOUT_LIMIT_EXCEEDED), ainsi que les contrôles de risque (403 TRANSACTION_BLOCKED).
Au-delà d’un seuil, ou si le risque est élevé, le versement attend une approbation (PENDING_APPROVAL).

Approbation : une autre personne, dans le tableau de bord

Un versement en attente ne peut être approuvé ou refusé que dans le tableau de bord, par un utilisateur qui a ce droit, avec une double authentification récente, et qui n’est pas celui qui l’a demandé. Aucune clé API ne peut approuver un versement. Un refus libère les fonds réservés.

Statuts

Statut	Signification
`PENDING_APPROVAL`	En attente d’approbation.
`APPROVED`	Approuvé, en cours d’envoi.
`PROCESSING`	Envoyé, en cours chez le fournisseur.
`SUCCEEDED`	Reçu par le bénéficiaire.
`FAILED`	Refusé par le fournisseur : les fonds reviennent sur votre solde.
`REJECTED`	Refusé lors de l’approbation : les fonds reviennent sur votre solde.
`CANCELLED`	Annulé.
`UNKNOWN`	Issue inconnue : ne renvoyez pas le versement, Galsen Pay vérifie.
`REVERSED`	Annulé par le fournisseur après coup.

Webhooks : payout.created, payout.succeeded, payout.failed.

Lire

GET/v1/payouts · /v1/payouts/{id}

Permission payouts:read. Filtre status, pagination par curseur. Objet : id, reference, provider, amount, fees, status, recipient (masqué), requiresApproval, failureCode, createdAt, completedAt.