> ## 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 se descuentan de tu saldo disponible de Fintoc, que excluye cualquier 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 de API [Cancelar reembolsos](/es/reference/payments-api/refunds/refunds-cancel) o contactar a nuestro equipo de soporte, pero **la cancelación no aparece en tu Dashboard de VTEX o Shopify**.
</Warning>

# Destinos de los reembolsos

El destino de un reembolso depende del método de pago utilizado.

Para la mayoría de los pagos, Fintoc reembolsa a la cuenta bancaria original utilizada para el pago. No necesitas especificar un destino.

Para [métodos de pago alternativos](/es/docs/payments/alternative-payment-methods), Fintoc no tiene acceso a la cuenta del pagador porque el cliente autoriza el pago a través del propio checkout del banco. Para reembolsar estos pagos, recopilas la cuenta de destino del cliente y la pasas como `recipient_account` cuando [creas el reembolso](/es/reference/payments-api/refunds/refunds-create).

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

Si planeas usar reembolsos, incluye un `customer_email` al crear tu Checkout Session para que Fintoc pueda notificar al cliente sobre el progreso de su solicitud de reembolso.

# Ciclo de vida del reembolso

### Chile 🇨🇱

Puedes crear reembolsos 24/7. Fintoc comienza a desembolsar cada reembolso cuando lo creas, en lugar de retenerlo para el siguiente ciclo de payout diario.

A las 14:00 hora de Santiago cada día, Fintoc reserva el saldo acumulado hasta ese momento para financiar tu payout diario. Un reembolso que crees después de las 14:00 no puede usar ese saldo reservado, por lo que Fintoc desembolsa el reembolso solo cuando se acumula nuevo saldo.

1. Un reembolso nuevo comienza con el estado `pending`. Puedes cancelar un reembolso mientras esté en `pending`.
2. Fintoc comienza a desembolsar el reembolso, el cual pasa al estado `in_progress`.
3. Después de que Fintoc finaliza el desembolso, el reembolso pasa al estado `succeeded`, y tu cliente ve el reembolso en su cartola bancaria.
4. Si tienes fondos insuficientes en tu saldo de Fintoc, Fintoc reintenta el reembolso durante 5 días hábiles. Si el reembolso no se completa exitosamente dentro de los 5 días hábiles, pasa al estado `failed`. Cualquier otra falla al transferir los fondos también marca el reembolso como `failed`, y los fondos se incluyen en tu siguiente payout.

### México 🇲🇽

Puedes crear reembolsos 24/7. Fintoc comienza a desembolsar cada reembolso cuando lo creas, en lugar de retenerlo para el siguiente ciclo de payout diario.

1. Un reembolso nuevo comienza con el estado `pending`. Puedes cancelar un reembolso mientras esté en `pending`.
2. Fintoc comienza a desembolsar el reembolso, el cual pasa al estado `in_progress`.
3. Después de que Fintoc finaliza el desembolso, el reembolso pasa al estado `succeeded`, y tu cliente ve el reembolso en su estado de cuenta bancario.
4. Si tienes fondos insuficientes en tu saldo de Fintoc, Fintoc reintenta el reembolso durante 5 días hábiles. Si el reembolso no se completa exitosamente dentro de los 5 días hábiles, pasa al estado `failed`. Cualquier otra falla al transferir los fondos también marca el reembolso como `failed`, y los fondos se incluyen en tu siguiente payout.

# Emitir reembolsos

Puedes emitir reembolsos desde el [Dashboard](https://dashboard.fintoc.com) o usando la [API de Refunds](/es/reference/payments-api/refunds). Trata el reembolso como completo después de que alcance el estado `succeeded`. 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 con la API, [crea un reembolso](/es/reference/payments-api/refunds/refunds-create) con el ID del pago y define `resource_type` como `payment_intent`. Recibes este ID como parte del evento webhook `checkout_session.finished`. También puedes encontrarlo en el [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 pago, proporciona un `amount` en la [unidad mínima de la moneda](/es/docs/home/currencies). Por ejemplo, usa `1000` para `$1000 CLP` o `100` para `$1.00 MXN`.

```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

Puedes cancelar cualquier reembolso mientras su estado sea `pending`, desde el [Dashboard](https://dashboard.fintoc.com) o usando la API.

## Cancelar un reembolso usando la API

Para cancelar un reembolso usando la API, usa el endpoint [cancelar reembolso](/es/reference/payments-api/refunds/refunds-cancel) 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 envía [eventos de webhook](/es/docs/resources/webhooks-walkthrough) a tu servidor cuando cambia el estado de un Refund. Úsalos para notificar a tu cliente sobre actualizaciones, por ejemplo enviándole un correo cuando el reembolso aparezca 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 desembolsar el reembolso.                                                               | Notifica a tu cliente que el reembolso está en proceso y espera el evento `refund.succeeded` antes de tratar el reembolso como completo. |
| `refund.succeeded`   | Se envía cuando Fintoc procesa 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 el reembolso no pudo completarse.                                                                              |

# 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 [Obtener Voucher de Reembolso](/es/reference/payments-api/refunds/refunds-voucher). Al hacerlo, ten en cuenta que hay un tiempo de expiración de [5 minutos para iniciar la descarga](/es/reference/main-resources/vouchers/vouchers-object).

# Notificaciones de reembolso

Al configurar una `Checkout Session`, puedes incluir [un `customer_email` para notificaciones](/es/reference/payments-api/payment-intents/payment-intents-create). 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, también lo notificará.

# 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.