Webhooks

This page explains how Fintoc webhooks work and how to set one up. A webhook lets Fintoc notify your server when an action happens on Fintoc's side. Your application can react to the action and stay in sync with Fintoc.

Fintoc uses webhooks to notify your application when events happen on your users' bank accounts. For example, the account holder changes their bank password and Fintoc can no longer obtain new movements. As another example, a check is protested and its movement no longer exists in the bank. Fintoc also uses webhooks to notify you about events that happen on Fintoc itself. For instance, an account finishes syncing with the latest available data from the bank.

To use the Fintoc webhooks, you need to follow three steps:

• Create a webhook endpoint on your server (an endpoint that receives the webhooks).
• Test the webhook endpoint with test events.
• Register the webhook endpoint in Fintoc.

A webhook endpoint is a route in your application that receives Fintoc's notifications. Give the endpoint a URL where Fintoc sends notifications about new actions. Each notification is an Event object, which contains all the relevant information about what happened. The webhook endpoint should use this information to perform any necessary action to maintain the correct state in the application. For example, you may need to prompt the account holder to reconnect their bank account with Fintoc after they change the bank password.