Balance monitoring

Balance monitors let you keep track of balances in your Blnk Ledger. This is useful for scenarios where balances should meet specific thresholds.

You can monitor all 3 sub-balances of a ledger balance — credit balance (credit_balance), debit balance (debit_balance) and total balance (balance).

Let’s get started ✨

What we’ll cover …

1. Why monitor balances?
2. Set up balance monitors
3. Supported operators
4. Manage existing balance monitors

​

1. Why monitor balances?

1. Fraud detection: Unusual balance changes can be an early indication of fraudulent activities. Monitoring can trigger alerts for suspicious transactions and ensure timely intervention.

2. Regulatory compliance: Many financial regulations require institutions to maintain specific balance thresholds. Real-time balance monitoring makes it easy to comply with these regulations.

3. Customer notifications: Customers can be notified in real-time if their balance crosses a specific threshold. It can also be used for segmenting your customers in your application.

4. Operational efficiency: Instantly knowing when a balance reaches a certain threshold can trigger automatic actions, such as transferring funds between accounts or purchasing assets.

​

2. Set up balance monitors

To set up balance monitoring, you need to determine your conditions, e.g., notify me when the debit_balance is above 100000.

Next, call the create-balance-monitor endpoint and provide the following request body:

POST http://YOUR_BLNK_INSTANCE_URL/balance-monitors

{
    "balance_id": "bln_0be360ca-86fe-457d-be43-daa3f966d8f0",
    "condition": {
        "field": "debit_balance",
        "operator": ">",
        "value": 1000,
        "precision": 100
    },
    "description": "Tier 1 Account"
}

In this example, Blnk is asked to monitor the balance and send a notification when its debit_balance is greater than 100000.

Once the request is received, Blnk stores your balance monitor with a unique monitor_id. When the condition is met, you will get instantly notified via the balance.monitor webhook event.

{
    "monitor_id": "mon_e0e77b0c-4985-472a-9bf5-76a48b0259b0",
    "balance_id": "bln_0be360ca-86fe-457d-be43-daa3f966d8f0",
    "condition": {
        "field": "debit_balance",
        "operator": ">",
        "value": 1000000
    },
    "description": "Tier 1 Account",
    "created_at": "2024-02-20T05:56:58.257315054Z"
}

​

3. Supported operators

This is a list of all supported operators by the Balance monitor:

​

4. Manage existing balance monitors

You can request to view or update the details of a particular monitor.

To view balance monitors, call the get-balance-monitor endpoint:

GET http://YOUR_BLNK_INSTANCE_URL/balance-monitors/{monitor-id}

To update a balance monitor, call the update-balance-monitor endpoint:

PUT http://YOUR_BLNK_INSTANCE_URL/balance-monitors/{monitor-id}

and provided the updated conditions in the request body.

​

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please join our Discord community.