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 typedata.objectDescriptionWebhookEndpoint
link.createdlinkTriggers when a Link is created
link.credentials_changedlinkTriggers when the credentials corresponding to a Link change and the Link needs to be reconnected:white-check-mark:
link.refresh_intent.succeededrefresh_intentTriggers when a Link has been completely updated. For now, it is only triggered for electronic invoices:white-check-mark:
account.refresh_intent.succeededrefresh_intentTriggers when an Account is updated with the latest available movements from the bank:white-check-mark:
payment_intent.succeededpayment_intentTriggers when a transfer (Payment Intent) finishes successfully:white-check-mark:
payment_intent.rejectedpayment_intentTriggers when a transfer (Payment Intent) fails due to the bank rejecting it:white-check-mark:
payment_intent.failedpayment_intentTriggers when a transfer (Payment Intent) fails:white-check-mark:
subscription_intent.succeededsubscription_intentTriggers when a subscription intent is validated as successful. The subscription_intent includes the resulting subscription object.:white-check-mark:
subscription_intent.failedsubscription_intentTriggers when a subscription intent fails due to a problem with the bank or Fintoc.:white-check-mark:
subscription_intent.rejectedsubscription_intentTriggers 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.activatedsubscriptionTriggers when the bank has confirmed that the subscription is ready to accept charges.:white-check-mark:
subscription.canceledsubscriptionTriggers when the bank informs Fintoc that the subscription has been canceled.:white-check-mark:
charge.succeededchargeTriggers when a charge is validated as successful.:white-check-mark:
charge.failedchargeTriggers 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.