Introduction

Receive event notifications with webhooks

Listen for events on your Fido account so your integration can automatically trigger reactions.

Fido uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a customer’s score is calculated.

Begin using webhooks with your Fido integration in two steps:

  • Create a webhook endpoint on your server.
  • Register the endpoint with Fido to go live.

What are webhooks

Webhooks refer to a combination of elements that collectively create a notification and reaction system within a larger integration.

Metaphorically, webhooks are like a phone number that Fido calls to notify you of activity in your Fido account. The activity could be the scoring of a new customer or a list of digital footprints. The webhook endpoint is the person answering that call who takes actions based upon the specific information it receives.

Non-metaphorically, the webhook endpoint is just more code on your server, which could be written in Ruby, PHP, Node.js, or whatever. The webhook endpoint has an associated URL (e.g., https://example.com/webhooks). This Event object contains all the relevant information about what just happened, including the type of event and the data associated with that event. The webhook endpoint uses the event details to take any required actions, such as approving a new customer.

When to use webhooks

Many events that occur within a Fido account have synchronous results–immediate and direct–to an executed request. For example, a successful request to create a customer immediately returns a Customer object. Such requests don’t require webhooks, as the key information is already available.

Other events that occur within a Fido account are asynchronous: happening at a later time and not directly in response to your code’s execution.

Webhook flow:

  • User Fill a web-form with fido.js installed.
  • Fido's server receives the user information, this can be done automatically if the FIDO JS is set to "auto-capture" See Installation Guide.
  • Fido elaborates the request, enriches the data, and produces a score.
  • A score event is then sent to a specific URL via HTTP POST method.

📘

"Auto-capture" is the default setting of the FIDO JS.

If you need to set up or edit your webhook URL just reach out to your account manager


Did this page help you?