Table of Contents | ||||
---|---|---|---|---|
|
...
What is a webhook?
Webhook is an API concept that allows applications communicate between themselves automatically without polling. Whenever an action/event happens on App A, it can automatically send updates to App B without App B polling constantly.
...
The destination of this notification is a URL on your server, that accepts a POST request.
...
Supported Webhook Events
An event is an action that is done on your integration for which you can be notified of.
...
Click here to see all supported event types and the payload structure.
Securing your webhook
You can secure your webhook by using a combination of the approaches below
Transaction Hash Validation: This is applicable by default on our transaction notification webhook. A hash of some properties in the request payload is computed, and you can validate this on your server by computing the same hash and comparing outputs. For more information about this, please see Computing Request Validation Hash
IP Whitelisting: To prevent requests from un-authorized origins, you can whitelist our IP address and only honor requests from this IP. Webhook notifications from Monnify will come from the following IP addresses - 35.242.133.146
Responding to webhook request
When notification is sent to your server, we expect a 200 HTTP Status Code. When we get this, we assume the notification has been successfully received.
...
Monnify ignores any other information in the response body or headers.
Best Practices
It’s highly recommended you do the following when processing webhook notifications from us.
...