Setup Webhook

Our webhooks provide real-time notifications when certain events happen on your account. These events could range from a successful transaction to a failed transaction.

Some examples of events that you could be notified of include:

• When you receive a settlement transaction.
• When you performed a successful payout transaction.

Some examples of things you could do with our webhooks include :

• Update your database when the status of a pending payment is successful.
• Notify a customer when payment is successful or unsuccessful etc.

In order to receive these notifications, you need the following:

• An endpoint on your server that will be called by us to send you notifications
• Webhook enabled on your Fincra dashboard.

How To Enable Webhooks On Your Fincra Portal

To enable webhook, kindly follow the steps below:

Step 1

Log into your Fincra dashboard. Then click on the settings page in the navigation bar, then click on My Account.

Step 2

Go to the API keys and webhook Configuration tab on the Settings page paste the URL of your server endpoint in the appropriate webhook URL field.

Step 3

Hit save, toggle on the webhook and you are good to go.

Webhook Events 🪝.

Please feel free to read more on our webhooks and the types of events we support

Payouts events
Collection events
Conversion events
virtual account events

Webhook Validation

• Depending on the type of transaction you can validate a webhook by querying the transaction by its reference to confirm its existence
• Webhook signature verification , you can verify our webhook signature