Skip to main content
POST
/
v1
/
refunds
Créer un remboursement
curl --request POST \
  --url https://api.example.com/v1/refunds

​
Créer un remboursement

Permet de retourner des fonds à un client. Le montant sera débité du solde disponible du marchand.

​
Body

ParamètreTypeRequisDescription
payment_idstring✅ID du paiement original
amountinteger✅Montant à rembourser
reasonstringRaison du remboursement
refund_feesbooleanSi true, tente de rembourser également les frais de plateforme

​
Exemple

curl -X POST https://api.sahelpay.ml/v1/refunds \
  -H "Authorization: Bearer sk_live_xxx" \
  -d '{
    "payment_id": "txn_123",
    "amount": 1000,
    "reason": "Client insatisfait"
  }'

​
Réponse

{
  "success": true,
  "data": {
    "id": "ref_abc123",
    "status": "COMPLETED",
    "amount": 1000,
    "currency": "XOF",
    "created_at": "2025-12-19T11:00:00Z"
  }
}