Skip to main content
This page explains how Fintoc webhooks work and how to set them up. Webhooks notify your server when an event occurs in Fintoc. Your application can respond to the event and stay synchronized with Fintoc. Fintoc uses webhooks to notify your application about events in your users’ bank accounts. For example, Fintoc can no longer retrieve new movements after an account holder changes their bank password. Another event occurs when the movement for a protested check no longer exists in the bank. Fintoc also sends webhooks for events within Fintoc. For example, Fintoc sends an event when an account finishes syncing with the latest available data from the bank. To use Fintoc webhooks, follow these steps:
  1. Create a webhook endpoint on your server to receive webhooks.
  2. Test the webhook endpoint with test events.
  3. Register the webhook endpoint in Fintoc.
Once your endpoint runs in live mode, recover missed events to catch up on the events your endpoint did not process during an outage. A webhook endpoint is a route in your application that receives notifications from Fintoc. Assign the endpoint a URL that Fintoc can use to send notifications. Fintoc sends each notification as an Event object. The object contains information about what happened. Use this information in your webhook endpoint to keep your application’s state synchronized. For example, you may need to prompt an account holder to reconnect their bank account with Fintoc after changing their bank password.