Test your webhook endpoint

Test your webhook endpoints before registering them in live mode.

Test endpoints locallyUse a tool such as localtunnel to test endpoints during local development. Localtunnel exposes a local port to the internet and returns a public URL. Register this URL as your endpoint.

Test your webhooks through the dashboard

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

In the dashboard’s webhooks section, register a webhook endpoint in test mode.
Select the webhook endpoint to open its detail drawer.
Click the send-test icon for each subscribed event to send a test webhook.

The dashboard sends the test event to your webhook endpoint and displays the event details. Test events carry fake data that you cannot use to query the Fintoc API. For example, a test account.refresh_intent.succeeded event has the following JSON payload:

{
  "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"
}

The refreshed_object_id value, acc_00000000, identifies a fake account. The get account endpoint cannot return details for this account.

Live mode webhooksYou cannot test live mode webhooks through the dashboard. Fintoc sends live mode events only under specific conditions, such as when a connected account updates with its latest bank movements.

Create your webhook endpoint Validate webhook signatures

⌘I

Home

Resources

Payments

Transfers

Movements

Test your webhook endpoint

Test your webhooks through the dashboard

​Test your webhooks through the dashboard

Test your webhooks through the dashboard