Mark installment as refunded

POST https://api.staging.zafepay.com/api/v1/integration/installments/{installment_id}/mark_as_refunded

For refunds you process outside Zafepay (e.g. a bank transfer to the customer) that still need to be reflected on the installment. This does not call any payment provider — it only updates the installment's and transaction's status and leaves an audit trail.

Action only allowed when the installment's status is paid, it has an accepted payment transaction, and that transaction's charge group contains only this installment (installments charged together with others in the same group are not refundable through this endpoint).

Response Schema (200 OK)

Field	Type	Example
id	string	b2c1a0f0-1111-2222-3333-444455556666
status	string	refunded_manually
currency	string	CLP
due_date	string	2026-08-05
created_at	string	2026-08-01T09:00:00
payment_date	string	2026-08-05T14:32:10
amount	integer	15000
service_name	string	Monthly Plan

📘

On success, the installment's accepted payment transaction is also moved to reversed_manually, and a note ("Reembolso manual registrado vía API") is attached to the installment for audit purposes.