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

# Balance: Transfer

`POST /balances/{currency}/transfer`

Transfers funds from the currently authenticated merchant's balance to another
associated merchant for the given `currency`.

## Path parameters

- `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
  - `amount` integer, required — Amount greater than or equal to 0, in the lowest denomination of the currency (e.g. cents for USD).
  - `to` string, required

## Response `200`

200 response

- Transfer
  - `type` string, required — The type identifier for this 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 transfer occurred.

---

[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/versions/65483c40ba32/schema)