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.

🚧

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.

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 Payment Intent finishes successfully:white-check-mark:
payment_intent.rejectedpayment_intentTriggers when a user rejects a Payment Intent:white-check-mark:
payment_intent.failedpayment_intentTriggers when a Payment Intent fails due:white-check-mark:
payment_intent.pendingpayment_intentTriggers 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.:white-check-mark:
payout.createdpayoutTriggers when a Payout is created and starts processing:white-check-mark:
payout.succeededpayoutTriggers when a Payout is successfully transferred to your bank account:white-check-mark:
payout.canceledpayoutTriggers when a Payout is canceled and will not be sent to your bank account:white-check-mark:
refund.in_progressrefundTriggers when a Refund starts processing.:white-check-mark:
refund.succeededrefundTriggers when a Refund is successfully processed:white-check-mark:
refund.failedrefundTriggers when a Refund 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: