Multiple sources

Move money from multiple sources to a single destination.

Available in version 0.6.0 and later.

Overview

Blnk allows you to move money from multiple sources to a single destination in one transaction. This provides enhanced flexibility for complex money flows and makes tracking and reconciliation easier.

Multiple destinations

Move money from a single source to multiple destinations in one transaction.

---

What you’ll learn

1. How to send from multiple sources
2. Distribution types available
3. How transaction references work

---

Example scenario

A customer receives USD 30,000 from three sources. Here’s how the transaction is structured:

Multiple sources transaction flow

	Balance ID	Amount
Alice	bln_f2073f6b-905a-4e3e-b5a2-8d1b3dc2fb7f	10% (USD 3,000)
Bob	bln_64c50fb5-32d5-4f78-9f4a-e8b01aaf025d	USD 20,000
Charlie	bln_7d98dfe9-5c3e-4c9b-b96a-65f6d9f7b89b	Remaining amount (USD 7,000)
Sarah (Recipient)	bln_92e4b9b6-0b85-4ef4-87a2-682c31500d38	Total: USD 30,000

When sending from multiple sources, you can only send to one destination.

---

Create multiple sources transaction

Call the Create Transaction endpoint with these fields:

cURL

curl -X POST http://localhost:5001/transactions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "amount": 30000,
    "precision": 100,
    "reference": "ref_001adcfgf",
    "currency": "USD",
    "sources": [
        {
            "identifier": "bln_f2073f6b-905a-4e3e-b5a2-8d1b3dc2fb7f",
            "distribution": "10%"
        },
        {
            "identifier": "bln_64c50fb5-32d5-4f78-9f4a-e8b01aaf025d",
            "distribution": "20000"
        },
        {
            "identifier": "bln_7d98dfe9-5c3e-4c9b-b96a-65f6d9f7b89b",
            "distribution": "left"
        }
    ],
    "destination": "bln_92e4b9b6-0b85-4ef4-87a2-682c31500d38",
    "description": "Payment to Sarah"
  }'

Field	Description	Required	Type
amount	Total amount to be received	Yes	float
precision	Converts amount to lowest unit. See Understanding precision	No	int64
reference	Unique transaction reference	Yes	string
currency	Asset class code.	Yes	string
sources	Array of source objects with identifier and distribution fields	Yes	array
sources.identifier	Balance ID of the source account	Yes	string
sources.distribution	Amount to send from this source (specific amount, percentage, or “left”)	Yes	string
destination	Recipient’s balance ID	Yes	string
meta_data	Custom transaction data	No	object

When sending from multiple sources, do not include the source field in your payload. Use the sources array to group the participating balances in your payload.

---

API response structure

When you create a multiple sources transaction, Blnk .

Blnk returns a response containing:

• A main transaction ID for the overall split transaction. If inflight: true, it can be used to commit or void all transactions at once.
• A sources array with individual transaction IDs for each source.

Response

{
    "precise_amount": 3000000,
    "amount": 30000,
    "rate": 1,
    "precision": 100,
    "overdraft_limit": 0,
    "transaction_id": "txn_0b59f6e-6c4a-4efa-915c-526f77ef61ab",
    "parent_transaction": "",
    "source": "",
    "reference": "ref_001adcfgf",
    "currency": "USD",
    "description": "txn",
    "status": "QUEUED",
    "hash": "8cfdc0f2562ce30c3728ef624dc29fbd0e4207c77df9220df0c699d45de0eef",
    "allow_overdraft": true,
    "inflight": false,
    "skip_queue": false,
    "atomic": false,
    "sources": [
        {
            "identifier": "@test-2024",
            "distribution": "10%",
            "transaction_id": "txn_59347177-aa7e-d8ad-9f4f-d09628b32ec3"
        },
        {
            "identifier": "@test-21",
            "distribution": "20000",
            "transaction_id": "txn_7ddc8d4f-3b77-4b7d-a37f-240216ab074c"
        },
        {
            "identifier": "@test-218",
            "distribution": "left",
            "transaction_id": "txn_5aad04dd-ed53-4f77-9f01-4916d31fac5f"
        }
    ],
    "destination": "bln_92e4b9b6-0b85-4ef4-87a2-682c31500d38",
    "created_at": "2025-09-18T01:26:30.648049042Z",
    "scheduled_for": "0001-01-01T00:00:00Z",
    "inflight_expiry_date": "0001-01-01T00:00:00Z",
    "meta_data": {
        "QUEUED_PARENT_TRANSACTION": "txn_0b59f6e-6c4a-4efa-915c-526f77ef61ab"
    }
}

Retrieving child transactions

You can retrieve all transactions in the split by searching for the main transaction ID in the meta_data.QUEUED_PARENT_TRANSACTION field:

cURL

curl -X POST "http://localhost:5001/search/transactions" \
  -H "X-Blnk-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "txn_0b59f6e-6c4a-4efa-915c-526f77ef61ab",
    "query_by": "meta_data.QUEUED_PARENT_TRANSACTION"
  }'

This will return all individual transactions that were created as part of the multiple sources transaction, allowing you to track and manage the complete set of related transactions.

---

Distribution types

You can specify distribution amounts in three ways:

Type	Description	Example
Specific amount	Fixed amount to send	"distribution": "20000"
Percentage	Percentage of total amount	"distribution": "10%"
Remaining	Leftover amount after other distributions	"distribution": "left"

You can only use "left" once per transaction, and all distributions must sum to the total amount.

---

Transaction references

Blnk automatically generates unique references for each transaction record by appending a counter to your original reference (starting from 1).

Example: If your reference is ref_001adcfgf, the generated references will be:

• ref_001adcfgf1 (first source)
• ref_001adcfgf2 (second source)
• ref_001adcfgf3 (third source)

This ensures traceability while maintaining connection to the original transaction.

---

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 contact us or join our Discord community.

---

Tip: Connect to Blnk Cloud to see your Core data.

You can view your transactions, manage identities, create custom reports, invite other team members to collaborate, and perform operations on your Core — all in one dashboard.

Check out Blnk Cloud →