Devuelve el dinero con que se pagó una deuda, total o parcialmente.
Se usa cuando el punto de partida es la Invoice y no el pago: Toku busca el pago que la saldó y crea la devolución sobre esa Transaction.
Solo aplica a Invoices saldadas en un único pago. Si la Invoice fue pagada en más de una Transaction, la petición es rechazada y la devolución debe pedirse sobre la Transaction.
Si se omite refund_amount, se devuelve el monto total del pago que saldó la Invoice.
La operación no es idempotente: cada llamada crea una devolución nueva y las parciales se acumulan sobre el mismo pago, así que reenviar la misma petición vuelve a devolver el monto mientras quede saldo; cuando ya no queda, la petición es rechazada con estado 400.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400La Invoice fue pagada en más de una Transaction: en ese caso la devolución se pide sobre la Transaction, no sobre la Invoice.
403La Invoice pertenece a otra organización, o el gateway del pago no tiene habilitadas las devoluciones para tu organización.
404La Invoice indicada no existe, o no tiene ningún pago que devolver.
422El cuerpo de la petición no pasó la validación.