Webhooks

Webhooks

Payfi uses Webhooks to communicate updates on transaction objects initiated with the API and kick off additional workflows based on these events. Each time an event that you listen to occurs, Payfi submits a request to the designated Webhook URL with information about the event transactions.

If you have setup a webhook url on your Payfi Business dashboard, Payfi will send webhook events to notify data updates.

Payfi will call your webhook with the request below:

JSON

{
  "event": "payfi.events.payment",
  "status": "approved",
  "message": "string",
  "txRef": "42_1639832966"
}

Header

JSON

{
  "payfi-secret-key":"your secret key",
}

🚧

Authentication

Please check the header for this secret key before offering value.