Webhooks Overview
  • 26 Jul 2022
  • 2 Minutes To Read
  • Dark
    Light
  • PDF

Webhooks Overview

  • Dark
    Light
  • PDF

Webhooks are a system to system communication tool that use a push-based communication strategy to allow you to set up user-defined HTTP callbacks for events happening in the Mambu application.

For example, you may set up a webhook to notify one of your applications that a loan has been disbursed. Mambu will make a POST request to your application with a payload including information such as the loan account ID, client information, and amount. Your application can respond to this request itself or call back to Mambu to request more information and trigger additional actions in Mambu (such as creating a task or sending an email) or enrich and pass the call along to another partner service to trigger actions there.

For more information on setting up webhooks, see Defining a New Webhook.

Please Note

The Streaming API is another system to system communication tool however it uses a pull-based communication strategy and therefore its infrastructure is more suitable for use cases where multiple client applications must consume a large amount of data from the Mambu application. For more information, see Streaming API in our User Guide and Streaming API in our API Reference.

Benefits of using Webhooks

Audit

The communication history records every notification sent out. The notification is stored with the version of the payload computed at send-out so, in case of failure, the originally computed version of the payload can be resent.

Assured Delivery

The engine backs up the delivery of the notifications with a retry mechanism built on the exponential back-off pattern. In case of an undelivered notification, the system will attempt to perform the call five times at progressively increasing time intervals. If this threshold is reached with no success in the delivery, no automatic retry is performed. A manual, on-demand retry option via the Notifications API can be used for resending individual failed communications and is also available for bulk re-send.

Flexibility

Mambu's Webhooks are highly configurable, they allow you to:

  • Use an intuitive URL template for the call destination
  • Create payload templates which can transport static and dynamic information (through the use of placeholders) in any format to the destination. For more information, see Placeholders.
  • Support for REST API operations: POST, PUT, and PATCH.
  • Send data using structured JSON or XML content types, or simply as plain text
  • Set up custom request headers

Security

We highly recommend using HTTPS(TLS v1.2) for all communications.

Authenticated calls are supported as long as the receiver's end is geared up with an authentication layer based on the Basic Authentication strategy: username and password.

Webhooks will originate from a fixed set of IP addresses per Mambu region. For more information, see Sender IP addresses.

Ask the Mambu Community

If you have a question about how anything works or have come across something you haven't seen explained here, get in touch with our community of fellow users and Mambuvians where someone will lend a hand.


Was this article helpful?