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

# Types of events

This is a list of all the types of events we currently send. We may add more at any time, so in developing and maintaining your code, you should not assume that only these types exist.

Note that the events follow a sort of *pattern* in its naming: `resource.event`. Our goal is to have a consistent system so it feels intuitive and *easy* for you to use.

<Warning>
  The `link.created` is the only event that **cannot be listened using a Webhook Endpoint**. To receive said event, you need to pass the URL of your backend that you want to send the event to [when configuring the widget](/docs/resources/widget/widget-web-integration).
</Warning>

| Event type                                  | `data.object`                                                                                                | Description                                                                                                                                                                                                    |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account.refresh_intent.succeeded`          | [`refresh_intent`](/reference/movements-api/refresh-intents/refresh-intents-object)                          | Triggers when an `Account` is updated with the latest available movements from the bank                                                                                                                        |
| `account.refresh_intent.failed`             | [`refresh_intent`](/reference/movements-api/refresh-intents/refresh-intents-object)                          | Triggers when an update of the movements of a specific `Account` fails. **Only available for "Refresh On Demand" plans**                                                                                       |
| `account.refresh_intent.rejected`           | [`refresh_intent`](/reference/movements-api/refresh-intents/refresh-intents-object)                          | Triggers when an update of the movements of a specific `Account` fails because the `Link`credentials are invalid. **Only available for "Refresh On Demand" plans**                                             |
| `account.refresh_intent.movements_removed`  | [`refresh_intent`](/reference/movements-api/refresh-intents/refresh-intents-object)                          | Triggers when the Link's bank deletes transactions.<br />To enable these notifications, activate them from your [dashboard](https://dashboard.fintoc.com/webhook-endpoints).                                   |
| `account.refresh_intent.movements_modified` | [`refresh_intent`](/reference/movements-api/refresh-intents/refresh-intents-object)                          | Triggers when the Link's bank modifies transactions.<br />To enable these notifications, activate them from your [dashboard](https://dashboard.fintoc.com/webhook-endpoints) .                                 |
| `account_verification.succeeded`            | [`account_verificaton`](/reference/transfers-api/account-verification/account-verification-object)           | Triggers when the target account holder information has been retrieved successfully.                                                                                                                           |
| `account_verification.failed`               | [`account_verificaton`](/reference/transfers-api/account-verification/account-verification-object)           | Triggers when the target account holder information could not be retrieved.                                                                                                                                    |
| `account_number.deleted`                    | [`account_number`](/reference/transfers-api/account-numbers/account-number-object)                           | Triggers when an account number is deleted. Mexico only.                                                                                                                                                       |
| `charge.succeeded`                          | [`charge`](/reference/direct-debit-legacy/charges/charge-object)                                             | Triggers when a charge is validated as successful.                                                                                                                                                             |
| `charge.failed`                             | [charge](/reference/direct-debit-legacy/charges/charge-object)                                               | Triggers when a charge fails due to insufficient funds, the charged amount being higher than the authorized amount, or the user disabling the authorization.                                                   |
| `checkout_session.finished`                 | [`checkout_session`](/reference/payments-api/checkout-sessions/checkout-session-object)                      | Triggers when a customer has completed a payment. The webhook contains information about the Payment including its final status.                                                                               |
| `checkout_session.expired`                  | [`checkout_session`](/reference/payments-api/checkout-sessions/checkout-session-object)                      | Triggers when a customer leaves the payment flow before finishing                                                                                                                                              |
| `invoice.created`                           | [`invoice`](/reference/payments-api/invoices/invoice-object)                                                 | Triggers when an invoice is created                                                                                                                                                                            |
| `invoice.finalized`                         | [`invoice`](/reference/payments-api/invoices/invoice-object)                                                 | Triggers when an invoice is finalized and ready to be paid                                                                                                                                                     |
| `invoice.payment_created`                   | [`invoice`](/reference/payments-api/invoices/invoice-object)                                                 | Triggers when a payment for an invoice starts, either from an automatic charge or from your customer using the `hosted_invoice_url`                                                                            |
| `invoice.payment_failed`                    | [`invoice`](/reference/payments-api/invoices/invoice-object)                                                 | Triggers when an invoice payment attempt fails                                                                                                                                                                 |
| `invoice.payment_succeeded`                 | [`invoice`](/reference/payments-api/invoices/invoice-object)                                                 | Triggers when an invoice payment attempt succeeds                                                                                                                                                              |
| `invoice.voided`                            | [`invoice`](/reference/payments-api/invoices/invoice-object)                                                 | Triggers when an invoice becomes void and Fintoc disables its `hosted_invoice_url`                                                                                                                             |
| `link.created`                              | [`link`](/reference/movements-api/links/link-object)                                                         | Triggers when a `Link` is created                                                                                                                                                                              |
| `link.credentials_changed`                  | [`link`](/reference/movements-api/links/link-object)                                                         | Triggers when the credentials corresponding to a `Link` change and the `Link` needs to be reconnected                                                                                                          |
| `link.refresh_intent.succeeded`             | [`refresh_intent`](/reference/movements-api/refresh-intents/refresh-intents-object)                          | Triggers when a `Link` has been completely updated. For now, it is only triggered for electronic invoices                                                                                                      |
| `payment_intent.succeeded`                  | [`payment_intent`](/reference/payments-api/payment-intents/payment-intents-object)                           | Triggers when a `Payment Intent` finishes successfully                                                                                                                                                         |
| `payment_intent.rejected`                   | [`payment_intent`](/reference/payments-api/payment-intents/payment-intents-object)                           | Triggers when a  user rejects a `Payment Intent`                                                                                                                                                               |
| `payment_intent.expired`                    | [`payment_intent`](/reference/payments-api/payment-intents/payment-intents-object)                           | Triggers when a user doesn't complete a `Payment Intent`                                                                                                                                                       |
| `payment_intent.failed`                     | [`payment_intent`](/reference/payments-api/payment-intents/payment-intents-object)                           | Triggers when a  `Payment Intent` fails due                                                                                                                                                                    |
| `payment_intent.pending`                    | [`payment_intent`](/reference/payments-api/payment-intents/payment-intents-object)                           | Triggers when the final status of the payment is not available yet. A future webhook will be sent with the final status once it's determined.                                                                  |
| `payout.created`                            | [`payout`](/reference/payments-api/payouts/payout-object)                                                    | Triggers when a `Payout` is created and starts processing                                                                                                                                                      |
| `payout.succeeded`                          | [`payout`](/reference/payments-api/payouts/payout-object)                                                    | Triggers when a `Payout` is successfully transferred to your bank account                                                                                                                                      |
| `payout.canceled`                           | [`payout`](/reference/payments-api/payouts/payout-object)                                                    | Triggers when a `Payout` is canceled and will not be sent to your bank account                                                                                                                                 |
| `payout.returned`                           | [`payout`](/reference/payments-api/payouts/payout-object)                                                    | **Mexico only**<br />Triggers when a previously successful `Payout`  is returned from your bank account. Resources included in such payout should typically be included in the next one                        |
| `refund.in_progress`                        | [`refund`](/reference/payments-api/refunds/refund-object)                                                    | Triggers when a `Refund` starts processing.                                                                                                                                                                    |
| `refund.succeeded`                          | [`refund`](/reference/payments-api/refunds/refund-object)                                                    | Triggers when a `Refund` is successfully processed                                                                                                                                                             |
| `refund.failed`                             | [`refund`](/reference/payments-api/refunds/refund-object)                                                    | Triggers when a `Refund` fails                                                                                                                                                                                 |
| `subscription_intent.succeeded`             | [`subscription_intent`](/reference/direct-debit-legacy/subscriptions-intents/subscription-intent-object)     | Triggers when a subscription intent is validated as successful. The `subscription_intent` includes the resulting `subscription` object.                                                                        |
| `subscription_intent.failed`                | [`subscription_intent`](/reference/direct-debit-legacy/subscriptions-intents/subscription-intent-object)     | Triggers when a subscription intent fails due to a problem with the bank or Fintoc.                                                                                                                            |
| `subscription_intent.rejected`              | [`subscription_intent`](/reference/direct-debit-legacy/subscriptions-intents/subscription-intent-object)     | Triggers when a subscription intent is rejected by the user. This may happen when the user rejects the MFA step or if it is entered incorrectly.                                                               |
| `subscription.activated`                    | [`subscription`](/reference/direct-debit-legacy/direct-debit-subscriptions/direct-debit-subscription-object) | Triggers when the bank has confirmed that the subscription is ready to accept charges.                                                                                                                         |
| `subscription.canceled`                     | [`subscription`](/reference/direct-debit-legacy/direct-debit-subscriptions/direct-debit-subscription-object) | Triggers when the bank informs Fintoc that the subscription has been canceled.                                                                                                                                 |
| `subscription.payment_method_updated`       | [`subscription`](/reference/payments-api/subscriptions/subscription-object)                                  | Triggers when the bank confirms a new payment method mandate is active. Fintoc associates the new payment method with the subscription and charges future billing cycles against the payment method.           |
| `subscription.payment_method_update_failed` | [`subscription`](/reference/payments-api/subscriptions/subscription-object)                                  | Triggers when the bank rejects activation of a new payment method mandate. The subscription keeps its previous payment method, and open invoices stay collectible through each invoice's `hosted_invoice_url`. |
| `transfer.outbound.succeeded`               | [transfer](/reference/transfers-api/transfers/transfer-object)                                               | Triggers when the **Transfer** successfully settles.                                                                                                                                                           |
| `transfer.outbound.returned`                | [transfer](/reference/transfers-api/transfers/transfer-object)                                               | 🇲🇽 In Mexico: Triggers when either Banco de Mexico or the counterparty institution has rejected the transfer.<br />🇨🇱 In Chile: Triggers when the counterparty institution has rejected the transfer.      |
| `transfer.outbound.failed`                  | [transfer](/reference/transfers-api/transfers/transfer-object)                                               | Triggers when the **transfer** has not been able to reach its destination account, due to an error during the process.                                                                                         |
| `transfer.inbound.succeeded`                | [transfer](/reference/transfers-api/transfers/transfer-object)                                               | Triggers when a **Transfer** is successfully **received** in your account.                                                                                                                                     |
| `transfer.inbound.returned`                 | [transfer](/reference/transfers-api/transfers/transfer-object)                                               | 🇲🇽<br />Triggers when an **Inbound Transfer** has been **returned** by the recipient.                                                                                                                        |
| `transfer.inbound.rejected`                 | [transfer](/reference/transfers-api/transfers/transfer-object)                                               | 🇲🇽<br />Triggers when an **Inbound Transfer** has been **rejected** before being credited to your account.                                                                                                   |
