Webhooks to subscribe to automated notifications (i.e. events) from Finix's API.
When an events is triggered, a HTTP POST payload is sent to the URL that's configured in the webhook. Instead of manually pulling information from the API, webhooks push notifications to the configured URL.
Webhooks are useful for updating asynchronous state changes. This includes:
Events for newly created
You can create webhooks using your Finix Dashboard or Finix's API.
To create a webhook on the Finix Dashboard:
- Navigate to the PEOPLE header. Click Applications .
Application. Click the WEBHOOKS tab on the top navigation bar.
- Click Create Webhook and enter your webhook URL.
- Click Submit .
For details on how to create a webhook using Finix's API, see Create a Webhook.
You will receive a request for each individual event. For application
Webhooksyou’ll receive them for any state change that occurs with an Application. Such as a change in state for a
Merchantaccount provisioning, and Disputes.
- Whenever a state change occurs in the database the event will be fired off, thus making them as real-time as possible.
Is there a way to tell Finix that the event was successfully received? What type of response should we send?
- Any type of 200 HTTP code will suffice.
If the event wasn’t received, is it going to be sent again? What type of response/exception should I send?
Yes, if no response from the end-point is received by the
Webhookit automatically will be replayed.
Is Finix sending any confidential information? I’d like to know if using a public service, like https://pipedream.com, for testing the
Webhooks is an option.**
Yes, you can use
Webhooks. We won’t ever send sensitive credit card data, but will return DOBs and addresses. You can review the sample payloads .
- Here’s a list of our webhooks .
I’ll need a way to make sure that the same event is not processed twice, is it possible to include a unique ID in each request?
- We currently do not have this capability. It is on the roadmap, but unfortunately we don’t have a definitive timeframe.
I’ll need a way to consolidate our transactions with the information received from the event. Is there a processor transaction ID that will be sent with each event?
- Yes, there are resource ID’s that are in each response. Examples below:
- Transfer (e.g. debit, refund, credit)
- We submit the requests from multiple IP addresses.
- We can provide you a list of the IP addresses where you can expect to receive the events.
When I update the URL of a
Webhook through the API is there a delay before the new URL starts sending events? Do we need a grace period for the previous URL?
- There shouldn’t be any delays, but you can actually have multiple webhooks enabled at the same time to prevent any issues for migrating over to a new URL.
- There are five attempts to retry sending a Webhook event. The event won't be sent again after the five attempts.