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

# Tipos de eventos

Esta es una lista de todos los tipos de eventos que enviamos actualmente. Podemos agregar más en cualquier momento, así que al desarrollar y mantener tu código no debes asumir que solo existen estos tipos.

Ten en cuenta que los eventos siguen una especie de *patrón* en su nomenclatura: `resource.event`. Nuestro objetivo es contar con un sistema consistente para que su uso te resulte intuitivo y *fácil*.

<Warning>
  `link.created` es el único evento que **no puede escucharse mediante un Webhook Endpoint**. Para recibir dicho evento, debes pasar la URL de tu backend a la que quieras enviarlo [al configurar el widget](/es/docs/resources/widget/widget-web-integration).
</Warning>

| Tipo de evento                              | `data.object`                                                                                                   | Descripción                                                                                                                                                                                            |
| :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account.refresh_intent.succeeded`          | [`refresh_intent`](/es/reference/movements-api/refresh-intents/refresh-intents-object)                          | Se dispara cuando una `Account` se actualiza con los últimos movimientos disponibles del banco                                                                                                         |
| `account.refresh_intent.failed`             | [`refresh_intent`](/es/reference/movements-api/refresh-intents/refresh-intents-object)                          | Se dispara cuando falla la actualización de los movimientos de una `Account` específica. **Solo disponible para planes "Refresh On Demand"**                                                           |
| `account.refresh_intent.rejected`           | [`refresh_intent`](/es/reference/movements-api/refresh-intents/refresh-intents-object)                          | Se dispara cuando falla la actualización de los movimientos de una `Account` específica porque las credenciales del `Link` no son válidas. **Solo disponible para planes "Refresh On Demand"**         |
| `account.refresh_intent.movements_removed`  | [`refresh_intent`](/es/reference/movements-api/refresh-intents/refresh-intents-object)                          | Se dispara cuando el banco del Link elimina transacciones.<br />Para habilitar estas notificaciones, actívalas desde tu [dashboard](https://dashboard.fintoc.com/webhook-endpoints).                   |
| `account.refresh_intent.movements_modified` | [`refresh_intent`](/es/reference/movements-api/refresh-intents/refresh-intents-object)                          | Se dispara cuando el banco del Link modifica transacciones.<br />Para habilitar estas notificaciones, actívalas desde tu [dashboard](https://dashboard.fintoc.com/webhook-endpoints) .                 |
| `account_verification.succeeded`            | [`account_verificaton`](/es/reference/transfers-api/account-verification/account-verification-object)           | Se dispara cuando la información del titular de la cuenta destino se obtuvo correctamente.                                                                                                             |
| `account_verification.failed`               | [`account_verificaton`](/es/reference/transfers-api/account-verification/account-verification-object)           | Se dispara cuando la información del titular de la cuenta destino no pudo obtenerse.                                                                                                                   |
| `account_number.deleted`                    | [`account_number`](/es/reference/transfers-api/account-numbers/account-number-object)                           | Se dispara cuando se elimina un account number. Solo en México.                                                                                                                                        |
| `charge.succeeded`                          | [`charge`](/es/reference/direct-debit-legacy/charges/charge-object)                                             | Se dispara cuando un charge se valida como exitoso.                                                                                                                                                    |
| `charge.failed`                             | [charge](/es/reference/direct-debit-legacy/charges/charge-object)                                               | Se dispara cuando un charge falla por fondos insuficientes, porque el monto cobrado supera el monto autorizado, o porque el usuario deshabilitó la autorización.                                       |
| `checkout_session.finished`                 | [`checkout_session`](/es/reference/payments-api/checkout-sessions/checkout-session-object)                      | Se dispara cuando un cliente completa un pago. El webhook contiene información sobre el Payment incluyendo su estado final.                                                                            |
| `checkout_session.expired`                  | [`checkout_session`](/es/reference/payments-api/checkout-sessions/checkout-session-object)                      | Se dispara cuando un cliente abandona el flujo de pago antes de finalizar                                                                                                                              |
| `invoice.created`                           | [`invoice`](/es/reference/payments-api/invoices/invoice-object)                                                 | Se dispara cuando se crea una invoice                                                                                                                                                                  |
| `invoice.finalized`                         | [`invoice`](/es/reference/payments-api/invoices/invoice-object)                                                 | Se dispara cuando una invoice se finaliza y está lista para ser pagada                                                                                                                                 |
| `invoice.payment_created`                   | [`invoice`](/es/reference/payments-api/invoices/invoice-object)                                                 | Se dispara cuando comienza un pago de una invoice, ya sea desde un cobro automático o desde tu cliente usando el `hosted_invoice_url`                                                                  |
| `invoice.payment_failed`                    | [`invoice`](/es/reference/payments-api/invoices/invoice-object)                                                 | Se dispara cuando falla un intento de pago de una invoice                                                                                                                                              |
| `invoice.payment_succeeded`                 | [`invoice`](/es/reference/payments-api/invoices/invoice-object)                                                 | Se dispara cuando un intento de pago de una invoice resulta exitoso                                                                                                                                    |
| `invoice.voided`                            | [`invoice`](/es/reference/payments-api/invoices/invoice-object)                                                 | Se dispara cuando una invoice se anula y Fintoc deshabilita su `hosted_invoice_url`                                                                                                                    |
| `link.created`                              | [`link`](/es/reference/movements-api/links/link-object)                                                         | Se dispara cuando se crea un `Link`                                                                                                                                                                    |
| `link.credentials_changed`                  | [`link`](/es/reference/movements-api/links/link-object)                                                         | Se dispara cuando las credenciales asociadas a un `Link` cambian y es necesario reconectar el `Link`                                                                                                   |
| `link.refresh_intent.succeeded`             | [`refresh_intent`](/es/reference/movements-api/refresh-intents/refresh-intents-object)                          | Se dispara cuando un `Link` se ha actualizado por completo. Por ahora, solo se dispara para facturas electrónicas                                                                                      |
| `payment_intent.succeeded`                  | [`payment_intent`](/es/reference/payments-api/payment-intents/payment-intents-object)                           | Se dispara cuando un `Payment Intent` finaliza exitosamente                                                                                                                                            |
| `payment_intent.rejected`                   | [`payment_intent`](/es/reference/payments-api/payment-intents/payment-intents-object)                           | Se dispara cuando un usuario rechaza un `Payment Intent`                                                                                                                                               |
| `payment_intent.expired`                    | [`payment_intent`](/es/reference/payments-api/payment-intents/payment-intents-object)                           | Se dispara cuando un usuario no completa un `Payment Intent`                                                                                                                                           |
| `payment_intent.failed`                     | [`payment_intent`](/es/reference/payments-api/payment-intents/payment-intents-object)                           | Se dispara cuando un `Payment Intent` falla                                                                                                                                                            |
| `payment_intent.pending`                    | [`payment_intent`](/es/reference/payments-api/payment-intents/payment-intents-object)                           | Se dispara cuando el estado final del pago aún no está disponible. Se enviará un webhook posterior con el estado final una vez que se determine.                                                       |
| `payout.created`                            | [`payout`](/es/reference/payments-api/payouts/payout-object)                                                    | Se dispara cuando se crea un `Payout` y comienza a procesarse                                                                                                                                          |
| `payout.succeeded`                          | [`payout`](/es/reference/payments-api/payouts/payout-object)                                                    | Se dispara cuando un `Payout` se transfiere exitosamente a tu cuenta bancaria                                                                                                                          |
| `payout.canceled`                           | [`payout`](/es/reference/payments-api/payouts/payout-object)                                                    | Se dispara cuando un `Payout` se cancela y no será enviado a tu cuenta bancaria                                                                                                                        |
| `payout.returned`                           | [`payout`](/es/reference/payments-api/payouts/payout-object)                                                    | **Solo México**<br />Se dispara cuando un `Payout` previamente exitoso es devuelto desde tu cuenta bancaria. Los recursos incluidos en ese payout normalmente deberían incluirse en el siguiente       |
| `refund.in_progress`                        | [`refund`](/es/reference/payments-api/refunds/refund-object)                                                    | Se dispara cuando un `Refund` comienza a procesarse.                                                                                                                                                   |
| `refund.succeeded`                          | [`refund`](/es/reference/payments-api/refunds/refund-object)                                                    | Se dispara cuando un `Refund` se procesa exitosamente                                                                                                                                                  |
| `refund.failed`                             | [`refund`](/es/reference/payments-api/refunds/refund-object)                                                    | Se dispara cuando un `Refund` falla                                                                                                                                                                    |
| `subscription_intent.succeeded`             | [`subscription_intent`](/es/reference/direct-debit-legacy/subscriptions-intents/subscription-intent-object)     | Se dispara cuando un subscription intent se valida como exitoso. El `subscription_intent` incluye el objeto `subscription` resultante.                                                                 |
| `subscription_intent.failed`                | [`subscription_intent`](/es/reference/direct-debit-legacy/subscriptions-intents/subscription-intent-object)     | Se dispara cuando un subscription intent falla por un problema con el banco o con Fintoc.                                                                                                              |
| `subscription_intent.rejected`              | [`subscription_intent`](/es/reference/direct-debit-legacy/subscriptions-intents/subscription-intent-object)     | Se dispara cuando un subscription intent es rechazado por el usuario. Esto puede suceder cuando el usuario rechaza el paso de MFA o si lo ingresa incorrectamente.                                     |
| `subscription.activated`                    | [`subscription`](/es/reference/direct-debit-legacy/direct-debit-subscriptions/direct-debit-subscription-object) | Se dispara cuando el banco confirma que la subscription está lista para aceptar charges.                                                                                                               |
| `subscription.canceled`                     | [`subscription`](/es/reference/direct-debit-legacy/direct-debit-subscriptions/direct-debit-subscription-object) | Se dispara cuando el banco informa a Fintoc que la subscription ha sido cancelada.                                                                                                                     |
| `transfer.outbound.succeeded`               | [transfer](/es/reference/transfers-api/transfers/transfer-object)                                               | Se dispara cuando la **Transfer** se liquida exitosamente.                                                                                                                                             |
| `transfer.outbound.returned`                | [transfer](/es/reference/transfers-api/transfers/transfer-object)                                               | 🇲🇽 En México: se dispara cuando el Banco de México o la institución contraparte rechaza la transferencia.<br />🇨🇱 En Chile: se dispara cuando la institución contraparte rechaza la transferencia. |
| `transfer.outbound.failed`                  | [transfer](/es/reference/transfers-api/transfers/transfer-object)                                               | Se dispara cuando la **transfer** no pudo llegar a su cuenta destino, debido a un error durante el proceso.                                                                                            |
| `transfer.inbound.succeeded`                | [transfer](/es/reference/transfers-api/transfers/transfer-object)                                               | Se dispara cuando una **Transfer** se **recibe** exitosamente en tu cuenta.                                                                                                                            |
| `transfer.inbound.returned`                 | [transfer](/es/reference/transfers-api/transfers/transfer-object)                                               | 🇲🇽<br />Se dispara cuando una **Inbound Transfer** ha sido **devuelta** por el destinatario.                                                                                                         |
| `transfer.inbound.rejected`                 | [transfer](/es/reference/transfers-api/transfers/transfer-object)                                               | 🇲🇽<br />Se dispara cuando una **Inbound Transfer** ha sido **rechazada** antes de ser acreditada en tu cuenta.                                                                                       |
