Event Types

Below, you can find a list of every event we generate. We can add more events at any time, so when you develop your code, you shouldn't assume these are the only event types that 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.

Event type	`data.object`	Description
`link.created`	`link`	Triggers when a `Link` is created
`link.credentials_changed`	`link`	Triggers when the credentials corresponding to a `Link` change and the `Link` needs to be reconnected
`link.refresh_intent.succeeded`	`refresh_intent`	Triggers when a `Link` has been completely updated. For now, it is only triggered for electronic invoices
`account.refresh_intent.succeeded`	`refresh_intent`	Triggers when an `Account` is updated with the latest available movements from the bank
`payment_intent.succeeded`	`payment_intent`	Triggers when a transfer (`Payment Intent`) finishes successfully
`payment_intent.rejected`	`payment_intent`	Triggers when a transfer (`Payment Intent`) fails due to the bank rejecting it
`payment_intent.failed`	`payment_intent`	Triggers when a transfer (`Payment Intent`) fails
`subscription_intent.succeeded`	`subscription_intent`	Triggers when a subscription intent is validated as successful. The `subscription_intent` includes the resulting `subscription` object.
`subscription_intent.failed`	`subscription_intent`	Triggers when a subscription intent fails due to a problem with the bank or Fintoc.
`subscription_intent.rejected`	`subscription_intent`	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`	Triggers when the bank has confirmed that the subscription is ready to accept charges.
`subscription.canceled`	`subscription`	Triggers when the bank informs Fintoc that the subscription has been canceled.
`charge.succeeded`	`charge`	Triggers when a charge is validated as successful.
`charge.failed`	charge	Triggers when a charge fails due to insufficient funds, the charged amount being higher than the authorized amount, or the user disabling the authorization.

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