> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reembolsar pagos

> Aprende a reembolsar un pago.

Puedes reembolsar parcial o totalmente cualquier pago exitoso. Los reembolsos usan tu saldo disponible de Fintoc, que no incluye ningún saldo pendiente. Si tu saldo disponible no cubre el monto del reembolso, este se reintenta durante 5 días hábiles antes de expirar.

Además, Fintoc no devuelve las comisiones de procesamiento del pago original si este es reembolsado.

<Warning>
  **Reembolsos para plugins de e-commerce**

  Puedes **emitir** reembolsos directamente desde tu plataforma de e-commerce (VTEX o Shopify), pero debido al funcionamiento de los plugins, **los reembolsos solicitados desde plataformas de plugins de e-commerce no pueden cancelarse desde sus dashboards**.

  Si emitiste un reembolso desde una de estas plataformas y quieres cancelarlo, puedes usar nuestro endpoint Cancel Refunds API o contactar a nuestro equipo de soporte, pero por favor considera que **la cancelación no se reflejará en tu Dashboard de VTEX o Shopify**
</Warning>

# Destinos de los reembolsos

Los reembolsos solo pueden enviarse de vuelta a la cuenta bancaria original utilizada para el pago. No puedes enviar un reembolso a un destino diferente, como otra cuenta bancaria.

Si un cliente ha cerrado su cuenta bancaria, el reembolso se marca como fallido.

Si planeas usar reembolsos, asegúrate de incluir un `costumer_email` al crear tu Checkout Session para que Fintoc pueda notificar al usuario sobre el progreso de su solicitud de reembolso.

# Ciclo de vida del reembolso

### Chile 🇨🇱

Los reembolsos pueden crearse 24/7 y tardan máximo 1 día hábil en ejecutarse.

1. Un reembolso nuevo comienza con el estado `pending`.
2. A las 15:00, Fintoc comienza a procesar los reembolsos creados antes de las 14:00. Esos reembolsos pasan al estado `in_progress`. No puedes cancelar un reembolso si está en `in_progress`. Este proceso ocurrirá exclusivamente a las 15:00 en días hábiles.
3. Dependiendo de cuándo se creó el reembolso, se ejecutará el mismo día o el siguiente día hábil. Una vez que el reembolso termine de procesarse, pasará a `succeeded`. Los reembolsos exitosos aparecen en la cartola bancaria de tu cliente en tiempo real.
   1. Los reembolsos creados antes de las 14:00 en un día hábil se ejecutarán el mismo día antes de las 19:00.
   2. Los reembolsos creados después de las 14:00 en un día hábil se ejecutarán al día siguiente antes de las 19:00.
4. Si tienes fondos insuficientes en tu saldo de Fintoc, Fintoc reintentará el reembolso durante 5 días hábiles. Si el reembolso no se completa exitosamente después de 5 días hábiles, pasa al estado `failed`. En caso de cualquier otra falla al intentar transferir los fondos, el reembolso también se marcará como `failed` y los fondos se incluirán en tu siguiente payout.

### México 🇲🇽

Los reembolsos pueden crearse 24/7 y tardan de 1 a 2 días hábiles en ejecutarse.

1. Un reembolso nuevo comienza con el estado pending.
2. A las 18:00, Fintoc comienza a procesar los reembolsos creados antes de las 14:00. Esos reembolsos pasan al estado in\_progress. No puedes cancelar un reembolso si está en in\_progress. Este proceso ocurrirá exclusivamente a las 18:00 en días hábiles.
3. Si tarda 1 o 2 días hábiles en procesarse depende de cuándo se creó el reembolso. Una vez que el reembolso termine de procesarse, pasará a succeeded. Los reembolsos exitosos aparecen en la cartola bancaria de tu cliente en tiempo real.
   1. Los reembolsos creados antes de las 14:00 en un día hábil terminarán de procesarse el siguiente día hábil antes de las 14:00.
   2. Los reembolsos creados después de las 14:00 en un día hábil terminarán de procesarse en los próximos 2 días hábiles antes de las 14:00.
4. Si tienes fondos insuficientes en tu saldo de Fintoc, Fintoc reintentará el reembolso durante 5 días hábiles. Si el reembolso no se completa exitosamente después de 5 días hábiles, pasa al estado failed. En caso de cualquier otra falla al intentar transferir los fondos, el reembolso también se marcará como failed y los fondos se incluirán en tu siguiente payout.

# Emitir reembolsos

Puedes emitir reembolsos usando la API de Refunds. Los reembolsos exitosos aparecen en la cartola bancaria de tus clientes en 1 a 2 días hábiles. Puedes emitir más de un reembolso contra un pago, pero no puedes reembolsar un total mayor al monto del pago original.

## Emitir un reembolso usando la API

Para reembolsar un pago usando la API, crea un reembolso proporcionando el ID del pago y define el resource type como `payment_intent`. Recibirás este ID como parte del webhook del evento `checkout_session.finished`. También puedes obtener este valor desde nuestro [Dashboard](https://dashboard.fintoc.com).

```curl theme={null}
curl --request POST "https://api.fintoc.com/v1/refunds" \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "resource_id": "pi_ja12Nqa3Lb4s",
  "resource_type": "payment_intent"
}'
```

Para reembolsar parcialmente un Payment, proporciona un parámetro `amount` como un [entero en centavos](/es/v2023-11-15/docs/home/currencies).

```curl theme={null}
curl --request POST "https://api.fintoc.com/v1/refunds" \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "resource_id": "pi_ja12Nqa3Lb4s",
  "resource_type": "payment_intent",
  "amount": 1000,
}'
```

# Cancelar un reembolso

Cada reembolso puede cancelarse mientras esté en estado `pending`.

## Cancelar un reembolso usando la API

Para cancelar un reembolso usando la API, usa el endpoint cancel refund proporcionando el ID del reembolso.

```curl theme={null}
curl --request POST "https://api.fintoc.com/v1/refunds/REFUND_ID/cancel" \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json'
```

# Actualizaciones de estado del reembolso

Fintoc puede enviar eventos de [webhooks](/es/v2023-11-15/docs/resources/webhooks-walkthrough) a tu servidor para notificarte cuando cambie el estado de un Refund, lo cual puedes usar para propósitos como enviar un correo a tu cliente para informarle que debería ver el reembolso en su cartola bancaria.

Recomendamos manejar los siguientes eventos al reembolsar un pago:

| Evento               | Descripción                                                                                                               | Acción                                                                                                                        |
| :------------------- | :------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------- |
| `refund.in_progress` | Se envía cuando Fintoc comienza a procesar el reembolso.                                                                  | Notifica a tu cliente que el reembolso está en proceso y debería verlo reflejado en su cuenta bancaria en 1 o 2 días hábiles. |
| `refund.succeeded`   | Se envía cuando Fintoc procesó exitosamente el reembolso.                                                                 | Notifica a tu cliente que el dinero ya está en su cuenta bancaria.                                                            |
| `refund.failed`      | Se envía cuando el reembolso falló. Por ejemplo, el banco de tu cliente no pudo procesarlo o tienes fondos insuficientes. | Notifica a tu cliente que hubo un problema con el reembolso.                                                                  |

# Vouchers de reembolso

Fintoc ofrece Vouchers de Reembolso como confirmación de un reembolso exitoso a la cuenta bancaria de tu cliente. Para descargarlos, usa nuestro endpoint Retrieve Refund Voucher. Al hacerlo, ten en cuenta que hay un tiempo de expiración de 5 minutos para iniciar la descarga.

# Notificaciones de reembolso

Al configurar una `Checkout Session`, puedes incluir un `customer_email` para notificaciones. Si se proporciona un correo válido, se usará para informar al usuario sobre la creación de un reembolso, la transferencia exitosa de fondos a su cuenta bancaria y en caso de una falla en el reembolso.

# Comisiones de reembolso

Las comisiones de reembolso se calculan al descontarlas de tu payout. Si un reembolso resulta fallido, se reembolsará en tu siguiente payout.
