Test your webhook endpoint

You should always test that your webhook endpoints behave as expected before registering them in live mode.

📘

Testing endpoints locally

To test endpoints while you develop locally, use a tool such as localtunnel. The tool exposes a local port to the internet and returns a public URL you can register as your endpoint.

Testing your webhooks through the dashboard

You can test your webhook endpoints from the Fintoc Dashboard in three steps:

1. Register a webhook endpoint using the test mode from the webhooks section of the dashboard.
2. After registering the webhook endpoint, click on it to open a detail drawer.
3. Click the send-test icon on the right of each subscribed event to send a test webhook.

After you complete these steps, the dashboard shows the event it sent to your webhook endpoint.

Test events carry fake data that you cannot use to query the Fintoc API. For instance, a test account.refresh_intent.succeeded event returns the following JSON:

{
  "id": "evt_1zgnKZmDC2A59vrX",
  "type": "account.refresh_intent.succeeded",
  "mode": "test",
  "created_at": "2021-07-07T15:15:09.802Z",
  "data": {
    "object": "refresh_intent",
    "refreshed_object": "account",
    "refreshed_object_id": "acc_00000000",
    "status": "succeeded",
    "public_error": null,
    "created_at": "2021-06-28T00:00:00.000Z",
    "type": "only_last",
    "new_movements": 5
  },
  "object": "event"
}

Notice how the account id corresponds to acc_00000000, a fake account, so the get account endpoint cannot return its details.

📘

Live mode webhooks

You cannot test live mode webhooks through the dashboard, because Fintoc sends these events only under specific conditions (for example, when a connected account updates with its latest bank movements).