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

WebhookEndpoint

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

:white-check-mark:

link.refresh_intent.succeeded

refresh_intent

Triggers when a Link has been completely updated. For now, it is only triggered for electronic invoices

:white-check-mark:

account.refresh_intent.succeeded

refresh_intent

Triggers when an Account is updated with the latest available movements from the bank

:white-check-mark:

payment_intent.succeeded

payment_intent

Triggers when a transfer (Payment Intent) finishes successfully

:white-check-mark:

payment_intent.rejected

payment_intent

Triggers when a transfer (Payment Intent) fails due to the bank rejecting it

:white-check-mark:

payment_intent.failed

payment_intent

Triggers when a transfer (Payment Intent) fails

:white-check-mark:

subscription_intent.succeeded

subscription_intent

Triggers when a subscription intent is validated as successful. The subscription_intent includes the resulting subscription object.

:white-check-mark:

subscription_intent.failed

subscription_intent

Triggers when a subscription intent fails due to a problem with the bank or Fintoc.

:white-check-mark:

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.

:white-check-mark:

subscription.activated

subscription

Triggers when the bank has confirmed that the subscription is ready to accept charges.

:white-check-mark:

subscription.canceled

subscription

Triggers when the bank informs Fintoc that the subscription has been canceled.

:white-check-mark:

charge.succeeded

charge

Triggers when a charge is validated as successful.

:white-check-mark:

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.

:white-check-mark:

🚧

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.


Did this page help you?