Reembolsos

Reembolsa una transacción capturada total o parcialmente. Los reembolsos se procesan contra la tarjeta original y emiten un webhook payment.refunded.

Emitir un reembolso

POST /api/v1/payments/{transaction_id}/refund

{
  "amount": 1000,
  "reason": "Customer request"
}

Respuesta

{
  "id": "ref_xyz789",
  "payment_id": "txn_789xyz",
  "amount": 1000,
  "status": "completed",
  "created_at": "2026-05-05T12:00:00+00:00"
}

Reembolsos parciales y múltiples

• Establece amount menor que el monto original para un reembolso parcial.
• Se permiten múltiples reembolsos parciales hasta el total capturado.
• Cada reembolso dispara su propio webhook payment.refunded.

Cuándo usar refund vs void

Si la transacción subyacente está autorizada pero no capturada, usa Void en su lugar — libera la retención sin un registro de reembolso. Una vez capturada, solo aplica refund.

Códigos de razón

reason es texto libre, se almacena en el registro del reembolso y aparece en recibos y panel. Mantenlo amigable al cliente — aparece en la documentación de disputas.

Siguiente

• Capturas y anulaciones — para transacciones en modo authorize
• Webhooks — escucha payment.refunded