Webhooks - Async Updates

Many Feezback flows are asynchronous: a payment needs to clear with a bank, a consent needs to be confirmed by a user, an insights report needs to be computed. Rather than making you poll, Feezback pushes these state changes to your system as webhooks — HTTP POST calls to an endpoint you provide.

How it works

You expose a REST endpoint that accepts POST requests.
You give Feezback that endpoint's URL during integration setup (Integration Steps, step 5).
When an async event happens (payment status change, consent status change, mandate update, insights ready), Feezback sends a JSON payload to your endpoint.
Your endpoint must return HTTP 200 within 3 seconds.

If your processing takes more them 3 seconds please return us 200 status and process the update in your background

Payload envelope

{
  "timestamp": "2021-03-04T12:26:32.212913+00:00",
  "event": "EventName",
  "payload": { ... }
}

Do not validate against a strict schema / do not reject unknown fields. Banks may return additional fields inside payload that aren't listed below. Parse only the fields you need and ignore the rest.

Updated 7 days ago

Did this page help you?