Paiements

Refunds

Remboursez tout ou partie d’un paiement reussi. Le solde marchand est debite et le paiement change de statut.

Endpoints

POST/v1/refundsCreer un remboursementcle secrete

GET/v1/refundsLister les remboursementscle publique ou secrete

GET/v1/refunds/:idRecuperer un remboursementcle publique ou secrete

Rembourser

curl https://api.wanepay.com/v1/refunds \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_id": "pay_8f2k39dmz0qw",
    "amount": 2500,
    "reason": "Article manquant"
  }'

Parametres

Parametre	Type	Description
`payment_id`requis	string	Identifiant du paiement a rembourser.
`amount`	integer	Montant a rembourser. Omis, la totalite restante est remboursee.
`reason`	string	Motif interne (300 caracteres max).
`reference`	string	Votre reference.
`metadata`	object	Cles libres.

Regles

Seuls les paiements succeeded ou partially_refunded sont remboursables.
Le cumul des remboursements ne peut jamais depasser le montant du paiement.
Le solde disponible doit couvrir le remboursement, sinon insufficient_balance.
La connexion d’origine doit declarer la capacite refund. Certaines connexions ne supportent que le remboursement total : un remboursement partiel renvoie alors partial_refund_not_supported.
Le paiement passe a partially_refunded puis refunded lorsque la totalite est atteinte.

Frais

Les commissions prelevees sur le paiement d’origine ne sont pas restituees par defaut : seul le montant encaisse est contrepasse au ledger.

Ecritures generees

Un remboursement de 2 500 XOF produit deux ecritures equilibrees :

merchant_available    debit    2 500
network_settlement    credit   2 500