---
title: "Balance: Transfer"
method: POST
path: "/merchants/{merchant_id}/balances/{currency}/transfer"
tags: ["Platform Model"]
---

# Balance: Transfer

`POST /merchants/{merchant_id}/balances/{currency}/transfer`

Creates a balance transfer between associated merchants for a given `amount` and `currency`.

## Path parameters

- `merchant_id` string, required — A unique 25-character alphanumeric resource identifier.
- `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.

## Request body

- object
  - `merchant_id` string — A unique 25-character alphanumeric resource identifier.
  - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.
  - `to` string, required
  - `amount` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).

## Response `200`

200 response

- BalanceTransferServiceRecord
  - `type` string, required — The type identifier for this balance transfer record.
  - `recipient` string, required — Identifier of the merchant receiving the funds.
  - `remitter` string, required — Identifier of the merchant sending the funds.
  - `amount` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
  - `currency` 'JPY' | 'USD' | 'EUR' | 'TWD' | 'KRW' | 'PLN' | 'GBP' | 'HKD' | 'SGD' | 'NZD' | 'AUD' | 'IDR' | 'MYR' | 'PHP' | 'THB' | 'CNY' | 'BRL' | 'CHF' | 'CAD' | 'VND', required — 3-letter ISO currency code.
  - `happened_at` string, date-time, required — Timestamp when the balance transfer occurred.

## Other responses

- `403` — Does not allow access for unassociated merchants
- `502` — If the remitter does not have enough balance

---

[API](https://skmtc.net/komoju/apis/komoju-api.md) · [All operations](https://skmtc.net/komoju/apis/komoju-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komoju/komoju-api/revisions/65483c40ba32/schema)