Managing multiple destinations

​

Overview

Blnk provides a powerful tool that lets you process similar transactions from a single source to multiple destinations, providing your application with more customization and efficiency.

Simplified flow of how multiple destinations work

This provides enhanced flexibility and control over complex money flows within your application. By consolidating multiple sources into one single transaction, you can monitor and manage transactions more effectively, contextualize your transaction, and facilitate easier tracking and reconciliation.

See also → Managing multiple sources.

​

How it works

Say a customer wants to sends USD 30,000 from their account balance to three people. They want 20% to go to Person A, USD 10,000 to go to Person B, and the remaining amount to Person C.

Here’s a sample overview of their balance information:

{
    "amount": 30000,
	"precision": 100,
    "reference": "ref_001adcfgf",
    "currency": "USD",
    "source": "bln_92e4b9b6-0b85-4ef4-87a2-682c31500d38"
    "destinations": [
	    {
		    "identifier": "bln_f2073f6b-905a-4e3e-b5a2-8d1b3dc2fb7f",
		    "distribution": "20%",
		    "narration": "For groceries"
	    },
	    {
		    "identifier": "bln_64c50fb5-32d5-4f78-9f4a-e8b01aaf025d",
		    "distribution": "10000",
		    "narration": "For electricity bills"
	    },
	    {
		    "identifier": "bln_7d98dfe9-5c3e-4c9b-b96a-65f6d9f7b89b",
		    "distribution": "left",
		    "narration": "For savings"
	    }
    ]
}

​

Distribution types

There are three ways you can specify how the amount should be distributed among the sources as you’ve seen in the example above.

It is crucial to ensure that the total sum of your distribution fields is exactly equal to the value specified in the amount field.

​

Transaction references

Blnk auto-generates a unique transaction reference for each transaction record based on the original reference you provided in your transaction request.

A counter, starting at 1, is appended for each transaction record created ensuring that the individual transaction records have unique references derived from the original transaction reference. This makes sure that each transaction record is unique through its modified reference ensuring traceability and management while preserving the integrity of the original transaction’s reference.

To track your transaction, call the Get Transaction endpoint and provide the transaction id or reference to track a specific transaction in your Blnk Ledger.

See also → Search your Blnk data.

​

See also

​

Need help?

Are you stuck? Do you have a question that isn’t answered in this doc? Have you run into a problem you can’t solve? Want to file a bug report?

Join our Discord server and share your questions/thoughts with other developers building financial applications like you.