Rimborsi
Restituire tutto o parte di un incasso.
Creare un rimborso
POST /v1/refunds
| Campo | Obbligatorio | Descrizione |
|---|---|---|
payment_id |
sì | L'incasso originale: il suo identificativo o il suo riferimento |
amount_minor |
— | Stringa, in unità minori. Assente = il saldo residuo |
reason |
— | customer_request, duplicate, fraudulent o other |
description |
— | Testo libero, visibile nella dashboard |
Il rimborso è un'operazione a pieno titolo: un proprio id, un proprio stato, un proprio evento
webhook (refund.success / refund.failed).
Regole
- Si rimborsa solo un incasso riuscito.
- La somma dei rimborsi non può superare l'importo incassato — oltre, l'API risponde
422 invalid_request. - Le commissioni d'incasso non vengono restituite: restano a suo carico.
- Un rimborso parziale lascia l'incasso originale consultabile, con il suo storico completo.
- I fondi sono prelevati dal suo saldo disponibile al momento della chiamata, come per un pagamento.
Una chiave di idempotenza per rimborso. Mai l'identificativo del pagamento originale: un incasso può essere rimborsato in più volte, e una chiave che porti l'identificativo del padre farebbe passare il secondo rimborso parziale per una ripetizione del primo.
Leggere ed elencare
GET /v1/refunds/{id}
GET /v1/refunds