Refund representa un reembolso que creas contra un PaymentIntent. Fintoc devuelve el objeto Refund en las respuestas de la API de Refunds y en los eventos de webhook de refund. El campo status rastrea el desembolso, desde created a in_progress, y luego a succeeded, failed o canceled.
Refund Object
{
"id": "re_3MjTCxEhuqCR3lNz1NgprEoI",
"object": "refund",
"amount": 100,
"created_at": "2021-10-15T15:23:11.474Z",
"currency": "clp",
"failure_code": null,
"metadata": {},
"mode": "live",
"recipient_account": {
"holder_id": "111111111",
"holder_name": "Jane Doe",
"institution_id": "cl_banco_de_chile",
"number": "123456789",
"type": "checking_account"
},
"resource_id": "pi_3MjTCxEhuqCR3lNz1FLrtTeH",
"resource_type": "payment_intent",
"status": "succeeded",
"updated_at": "2021-11-15T12:23:11.474Z"
}
| Atributo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del refund. |
object | string | Tipo del objeto. Siempre refund. |
amount | integer | Monto reembolsado, en la unidad mínima de la moneda. Mayor que 0 y como máximo el monto original del PaymentIntent. Por defecto, el monto completo del PaymentIntent. |
created_at | string | Fecha y hora en ISO 8601 (UTC) en que se creó el refund. |
currency | string | Código de moneda ISO 4217 de tres letras, en minúsculas. Coincide con la moneda del PaymentIntent original. |
failure_code | string | null | Razón por la cual falló el refund. Uno de fraud_risk (bloqueado por los controles de fraude de Fintoc) o insufficient_funds (tu organización no tenía fondos para cubrir el refund). null a menos que el refund haya fallado. |
metadata | object | Conjunto de pares clave-valor que puedes adjuntar al refund, útil para almacenar información estructurada adicional. |
mode | string | Uno de live o test. Siempre coincide con el PaymentIntent original; no puedes crear un refund test para un PaymentIntent live, ni viceversa. |
recipient_account | object | null | Cuenta bancaria que recibe los fondos reembolsados. null para refunds que no se desembolsan por transferencia bancaria, como los refunds de tarjeta. Ver los atributos de recipient account abajo. |
resource_id | string | ID del PaymentIntent que se está reembolsando. |
resource_type | string | Tipo del recurso reembolsado. Siempre payment_intent. |
status | string | Estado actual del refund. Uno de created, in_progress, succeeded, failed o canceled. |
updated_at | string | Fecha y hora en ISO 8601 (UTC) en que se actualizó el refund por última vez. |
Recipient account
| Atributo | Tipo | Descripción |
|---|---|---|
holder_id | string | Tax ID del titular de la cuenta, sin puntos ni guiones. En Chile, un tax ID chileno (RUT); en México, un tax ID mexicano (RFC). |
holder_name | string | Nombre del titular de la cuenta. |
institution_id | string | Identificador de la institución de la cuenta. Ver códigos de instituciones de Chile. |
number | string | Número de cuenta que recibe los fondos reembolsados. |
type | string | Tipo de cuenta bancaria. Uno de checking_account o sight_account. |
Estados del Refund
| Estado | Descripción |
|---|---|
created | Fintoc creó el refund. El procesamiento comienza a las 18:00 del día hábil más cercano. |
in_progress | El refund se está procesando. Los fondos llegan a la cuenta bancaria de tu cliente en 1 a 2 días hábiles. |
succeeded | Fintoc transfirió el refund a la cuenta de tu cliente. |
failed | El procesamiento del refund falló. |
canceled | Cancelaste el refund antes de que comenzara el procesamiento. |