El objeto Refund

El objeto Refund representa un reembolso que creas para un PaymentIntent. Fintoc devuelve el objeto Refund en las respuestas de la API de reembolsos y en los eventos de webhook de reembolsos. El campo status registra el paso del reembolso de created a in_progress, y luego a succeeded, failed o canceled. Un reembolso en succeeded puede pasar después a returned si el banco del destinatario devuelve la transferencia.

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": "Test Customer 1",
    "institution_id": "cl_banco_de_chile",
    "number": "0000000000",
    "type": "checking_account"
  },
  "resource_id": "pi_3MjTCxEhuqCR3lNz1FLrtTeH",
  "resource_type": "payment_intent",
  "status": "succeeded",
  "updated_at": "2021-11-15T12:23:11.474Z"
}

El objeto Refund tiene los siguientes atributos:

Atributo	Tipo	Descripción
`id`	`string`	Identificador único del reembolso.
`object`	`string`	Tipo del objeto. Siempre `refund`.
`amount`	`integer`	Monto reembolsado, en la unidad mínima de la moneda. Debe ser mayor que `0` y como máximo igual al monto original del `PaymentIntent`. De forma predeterminada, corresponde al monto completo del `PaymentIntent`.
`created_at`	`string`	Fecha y hora en formato ISO 8601 y UTC en que se creó el reembolso.
`currency`	`string`	Código de moneda ISO 4217 de tres letras, en mayúsculas. Admite `CLP` o `MXN`. Coincide con la moneda del `PaymentIntent` original.
`failure_code`	`string` o `null`	Motivo por el que falló el reembolso. Admite `fraud_risk` (los controles de fraude de Fintoc bloquearon el reembolso) o `insufficient_funds` (tu organización no tenía fondos suficientes para cubrir el reembolso). Es `null` a menos que el reembolso haya fallado.
`metadata`	`object`	Conjunto de pares clave-valor que puedes adjuntar al reembolso. Permite almacenar información estructurada adicional.
`mode`	`string`	Admite `live` o `test`. Siempre coincide con el `PaymentIntent` original. No puedes crear un reembolso `test` para un `PaymentIntent` `live`, ni viceversa.
`recipient_account`	`object` o `null`	Cuenta bancaria que recibe los fondos reembolsados. Es `null` para los reembolsos que no se desembolsan mediante una transferencia bancaria, como los reembolsos de tarjeta. Consulta Cuenta receptora.
`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 reembolso. Admite `created`, `in_progress`, `succeeded`, `returned`, `failed` o `canceled`.
`updated_at`	`string`	Fecha y hora en formato ISO 8601 y UTC en que se actualizó el reembolso por última vez.

Cuenta receptora

El objeto recipient_account tiene los siguientes atributos:

Atributo	Tipo	Descripción
`holder_id`	`string`	Identificador tributario del titular de la cuenta, sin puntos ni guiones. En Chile, corresponde al Rol Único Tributario (RUT); en México, al Registro Federal de Contribuyentes (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. Admite `checking_account` o `sight_account`.

Estados del reembolso

El ciclo de vida del reembolso incluye los siguientes estados:

Estado	Descripción
`created`	Fintoc creó el reembolso. El procesamiento comienza a las 18:00 del día hábil más cercano.
`in_progress`	El reembolso 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 reembolso a la cuenta de tu cliente.
`returned`	El banco del destinatario devolvió la transferencia después de que el reembolso se completó. Este estado es final.
`failed`	El procesamiento del reembolso falló.
`canceled`	Cancelaste el reembolso antes de que comenzara el procesamiento.

API de Fintoc

Recursos principales

API de Pagos

API de Business Accounts

API de Movimientos

Direct Debit (Legacy)

API Fiscal

El objeto Refund

Cuenta receptora

Estados del reembolso

API de Fintoc

Recursos principales

API de Pagos

API de Business Accounts

API de Movimientos

Direct Debit (Legacy)

API Fiscal

​Cuenta receptora

​Estados del reembolso

Cuenta receptora

Estados del reembolso