Introduction
We use webhooks to notify your applications when specific events happen. For now the events available are AIS-related (if you use items and transactions for example). PIS-related events will come later.
Create a webhook from the dashboard
You can create webhooks from your dashboard. We will ask you to define:
- your callback URL for this webhook
- an optional name
- the events you want to receive
You can create up to 10 webhooks per application.
To secure your webhooks, we recommend you to use the secret
we provide when you create them. Please see the dedicated section to get the security best practices.
Note: only Admins can manage webhooks
Test your webhook with our test event
After creating a webhook, you can test it directly from your dashboard by clicking the "Send a test" button. We will send a fake event to your webhook, always with the same response:
{
"content": {
"item_id": 1234567890,
"status": 0,
"user_uuid": "9a95b38f-f98b-417a-988b-9d0d584893e7"
},
"timestamp": 1611681789,
"type": "TEST_EVENT"
}
Events
Different events can be triggered:
Banking Synchronization
- an item has been created
- an item has been refreshed
- an account has been created
- an account has been updated
Payment Initiation
- a payment transaction has been created
- a payment transaction has been updated
- a payment link has been updated
- a transfer account has been created
- a transfer account has been updated
- a transfer has been created
- a transfer has been updated
Please find the full list and details here.
Retry rules
When we call your webhook, we expect you to return a 200 response. Send a successful 200 response as quickly as possible because we retry the event if a response is not sent within a reasonable time. Write any long-running processes as code that can run asynchronously outside the webhook endpoint.
If we encounter an error with a message sent to your webhook (ie. http code different than 2xx
or a late response), we will try to resend the message for 1 to 2 days with an exponential back off.
Because of potential retries, you can receive webhooks for deleted users or items
Updated 2 months ago
What's Next
Secure your webhooks |
Webhooks events |