As a Platform Merchant (Platform Business) or Platform Merchant (Marketplace Business), you can define how frequently the funds in your balance and your sub-merchant's balances are automatically paid out to your bank account and their bank accounts respectively.

Payout settings

(1) For your account

You can set the Payout Frequency and Minimum Settlement Amount directly in KOMOJU Dashboard (Learn more)

(2) For your sub-merchant

Currently, the platform model only supports JPY payments. Sub-merchants will have balances only in JPY. You can update the following settings for each sub-merchant's JPY balance by using the Balances: Edit Settings API.

• Payout Frequency via frequency parameter
• Minimum Settlement Amount via settlement_minimum_amount parameter

To check the current payout settings for a sub-merchant, request Balance: Show Settings API.

📘

Platform Merchants and sub-merchants have independent payout settings

The Payout Frequency and Minimum Settlement Amount for each sub-merchant are configured individually and do not need to match the settings of the Platform Merchant.

Payout Frequency

The frequency attribute offers two options: weekly and monthly, applicable to both Platform Merchants and sub-merchants.

• Weekly Payout: Every Friday, payouts are processed for transactions captured from the Saturday of the prior week through the last Friday.
• Monthly payout: At the end of each month, payouts are processed for transactions captured during the previous month.

Please note that if the payment date is a holiday in Japan, the transfer will be made on the next business day (of the financial institution).

When adjusting the payout frequency of your account or your sub-merchant's account, keep the following in mind:

• Changing from monthly to weekly: The new payout cycle will be applied to the following month.
• Changing from weekly to monthly: The change will apply to the following week's transactions.
• If there are no transactions in the merchant account, the change will take effect immediately.

Example:

If you change your payout schedule from "Monthly" to "Weekly" in July, your July sales will be paid at the end of the following month (August 31) as usual. However, sales after August 1 will follow the weekly cycle, meaning they will be calculated on Friday and credited on August 14.

Minimum settlement amount

Via settlement_minimum_amountattribute, you can set up the minimum threshold to execute the payout.

For example, you set ¥100,000 as the minimum settlement amount for your sub-merchant. Assuming the cut-off date comes and the aggregation of the outstanding balance is ¥50,000, KOMOJU will skip this payout cycle and keep that ¥50,000 in sub-merchant's balance.