Solde et mouvements
Votre solde se calcule à partir du grand livre de Galsen Pay, tenu en partie double. Une écriture n’est jamais modifiée ni supprimée : une correction est une nouvelle écriture. La base de données refuse tout solde marchand négatif.
GET/v1/balance
Permission
balance:read.cURL
curl -s https://backend.v1.pay.galsen.tech/v1/balance -H "Authorization: Bearer $GALSEN_SECRET_KEY"
# {"success":true,"data":{"currency":"XOF","pending":9800,"available":0,"refundReserve":0,"payoutReserve":0},…}| Champ | Signification |
|---|---|
pending | Paiements encaissés, en attente de règlement (délai propre à votre compte). |
available | Disponible : utilisable pour les versements. |
refundReserve | Réservé aux remboursements en cours. |
payoutReserve | Réservé aux versements en cours. |
Mouvements
GET/v1/transactions
Permission
balance:read. Les écritures de vos comptes (MERCHANT_PAYABLE = en attente, MERCHANT_AVAILABLE = disponible), de la plus récente à la plus ancienne, paginées par curseur.Chaque écriture : id, type, referenceType et referenceId (le paiement, remboursement ou versement concerné), account, direction (CREDIT augmente votre solde, DEBIT le diminue), amount, createdAt.
| type | Opération |
|---|---|
PAYMENT_CAPTURE | Paiement encaissé (montant net crédité) |
SETTLEMENT | Règlement : passage de « en attente » à « disponible » |
REFUND_RESERVE / REFUND_COMPLETE / REFUND_RELEASE | Remboursement réservé, effectué, ou libéré après refus |
PAYOUT_RESERVE / PAYOUT_COMPLETE / PAYOUT_RELEASE | Versement réservé, effectué, ou libéré après échec |
REVERSAL / ADJUSTMENT | Correction ou ajustement passé par Galsen Pay |