Webhooks

Learn how to configure webhooks in the Mambu Payments (formerly Numeral) dashboard

Mambu Payments uses webhooks to notify your application when an event is created. Webhooks are particularly helpful for asynchronous events, such as a payment being executed by a partner bank or an account statement being received from a partner bank.

Events are created when an object is created or updated, either by a user using the API or the dashboard or by Mambu Payments. An update can be the update of any attribute, such as a status, a date, or any other data.

For each event, Mambu Payments will send a POST request to your API endpoint in JSON format. This API request contains an event object.

In order to use webhooks, you should create an API endpoint on your server and add it as a webhook in the Mambu Payments dashboard. To add a webhook:

  • Go to Developers > Webhooks > Add webhook
  • Enter a name and your API endpoint URL
  • Select the events you want this webhook to receive
  • Add an email address to be notified in case a webhook is deactivated due to repeated failed event deliveries
  • Click on Add webhook