Reembolsos

Devolver todo o parte de un cobro.

Crear un reembolso

POST /v1/refunds

Campo	Obligatorio	Descripción
payment_id	sí	El cobro original: su identificador o su referencia
amount_minor	—	Cadena, en unidades menores. Ausente = el saldo restante
reason	—	customer_request, duplicate, fraudulent u other
description	—	Texto libre, visible en el panel

El reembolso es una operación de pleno derecho: su propio id, su propio estado, su propio evento webhook (refund.success / refund.failed).

Reglas

• Sólo se reembolsa un cobro exitoso.
• La suma de los reembolsos no puede superar el importe cobrado — la API responde 422 invalid_request por encima.
• Las comisiones de cobro no se devuelven: quedan a su cargo.
• Un reembolso parcial deja el cobro original consultable, con su historial completo.
• Los fondos se toman de su saldo disponible en el momento de la llamada, como en un pago.

Una clave de idempotencia por reembolso. Nunca el identificador del pago original: un cobro puede reembolsarse en varias veces, y una clave que lleve el identificador del padre haría pasar el segundo reembolso parcial por un reenvío del primero.

Leer y listar

GET /v1/refunds/{id}
GET /v1/refunds