---
title: "Balance Transfers"
description: "How to initiate balance transfers between your Platform Merchant account and sub-merchant accounts using the KOMOJU API, with fund flow illustrations for each direction."
url: "https://docs.priv.staging.komoju-dev.tools/en/docs/platform-model/balance-transfers"
source_url: "https://docs.priv.staging.komoju-dev.tools/en/docs/platform-model/balance-transfers.md"
language: en
last_modified: "2026-03-26"
---

# Create a Balance Transfer

**(1) Setup**

As a Platform Merchant, you can initiate a balance transfer to move funds between your account and a sub-merchant's account. Transfers can be made from your balance to the sub-merchant's balance, or vice versa.

Note: The available balance must be equal to or greater than the transfer amount, or the request will fail.

**(2) Fund flow logic**

## Case 1: Transfer from Platform Merchant to a Sub-merchant

Request [Balance: Transfer](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/platform-model/POST/balances/%7Bmerchant_id%7D/balances/%7Bcurrency%7D/transfer) API to initiate a balance transfer from you to a sub-merchant.

```curl
curl https://komoju.com/api/v1/merchants/{merchant_id}/balances/{currency}/transfer \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
    "to": "seller_merchant_id",
    "amount": 300
}'

```

Fund flow illustration:

![](https://files.readme.io/295a364-Balance_Transfer_-_From_Platform_Merchant_to_Sub-merchant_.png)

## Case 2: Transfer from a Sub-merchant to Platform Merchant

Request [Balance: Transfer](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/platform-model/POST/balances/%7Bmerchant_id%7D/balances/%7Bcurrency%7D/transfer) API to initiate a balance transfer from a sub-merchant to you.

```curl
curl https://komoju.com/api/v1/merchants/{merchant_id}/balances/{currency}/transfer \
-u degica-mart-test: \
-X POST \
-H "Content-Type: application/json" \
-d '{
    "to": "platform_merchant_id",
    "amount": 300
}'

```

Fund flow illustration:

![](https://files.readme.io/9039707-Balance_Transfer_-_From_Sub-merchant_to_Platform_Merchant.png)

# Summary of transaction record types

The following transaction records are generated from the actions described above:

| Record type | Description | Deposit/Debit |
| --- | --- | --- |
| Balance Transfer | Transfer of account balance between you and your sub-merchant | Can be credit or debit, depending on who the beneficiary is |