# App\_fee\_money in Japan — Terminal API, POS API and e-money

**URL:** <https://developer.squareup.com/forums/t/app-fee-money-in-japan-terminal-api-pos-api-and-e-money/28116>\
**Category:** Questions\
**Created:** [October 6, 2026, 3:35am UTC](https://developer.squareup.com/forums/t/app-fee-money-in-japan-terminal-api-pos-api-and-e-money/28116 "2026-10-06T03:35:48Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![FLINK](https://avatars.discourse-cdn.com/v4/letter/f/919ad9/32.png) [@FLINK](https://developer.squareup.com/forums/u/FLINK)\
**Post date:** [October 6, 2026, 3:35am UTC](https://developer.squareup.com/forums/t/app-fee-money-in-japan-terminal-api-pos-api-and-e-money/28116/1 "2026-10-06T03:35:48Z")

</div>

Title: app\_fee\_money in Japan — Terminal API, POS API and e-money

We are building a salon app in Japan that connects each salon’s Square  
account via OAuth.

1. Is app\_fee\_money on CreateTerminalCheckout supported in production for  
Japan-based sellers? (A 2024 forum answer said Terminal app fees were  
US-only, but the docs now list CreateTerminalCheckout.)
2. Is there any way to collect an application fee on payments taken through  
the Point of Sale API (Square Reader + Square POS app)?
3. Can application fees be collected on e-money payments (iD, QUICPay,  
transit IC) in Japan?
4. Is the Mobile Payments SDK planned for Japan?

---

<div class="post-metadata">

**Author:** ![zacstlouis](https://avatars.discourse-cdn.com/v4/letter/z/b5a626/32.png) [@zacstlouis](https://developer.squareup.com/forums/u/zacstlouis)\
**Post date:** [October 6, 2026, 10:05pm UTC](https://developer.squareup.com/forums/t/app-fee-money-in-japan-terminal-api-pos-api-and-e-money/28116/3 "2026-10-06T22:05:23Z")

</div>

Hi! For a salon app connecting Japan-based Square sellers through OAuth:

1. Current documentation lists `app_fee_money` on `CreateTerminalCheckout`, and the Terminal API overview includes Japan among the regions for its payment features. I recommend verifying with a small checkout before building around it. You’ll need a Japan-based Square account to receive JPY fees, and the seller must authorize the required `PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS` scope.

2. No. The handoff to the Square POS app does not provide an `app_fee_money` parameter, and you cannot add a fee afterward to that POS payment. If collecting a fee on the in-person payment is required, consider a Terminal API checkout instead.

3. E-money app fees: I can’t confirm this, the docs outline the [supported methods here](https://developer.squareup.com/docs/payments-api/take-payments-and-collect-fees#application-fee-restrictions).

4. Mobile Payments SDK: It is [not currently available in Japan](https://developer.squareup.com/docs/international-development/japan). I’m not aware of a public Japan launch date or commitment.

Please read and be aware of [app\_fee limits](https://developer.squareup.com/docs/payments-api/take-payments-and-collect-fees#application-fee-limit) for Japan

---

<div class="post-metadata">

**Author:** ![FLINK](https://avatars.discourse-cdn.com/v4/letter/f/919ad9/32.png) [@FLINK](https://developer.squareup.com/forums/u/FLINK)\
**Post date:** [October 7, 2026, 3:51am UTC](https://developer.squareup.com/forums/t/app-fee-money-in-japan-terminal-api-pos-api-and-e-money/28116/4 "2026-10-07T03:51:48Z")

</div>

Thank you for the detailed reply. Follow-up questions for a Japan-based salon app (OAuth, Terminal API):

1. Has app\_fee\_money on CreateTerminalCheckout been confirmed to work on live (production) Japan accounts with JPY? A 2024 reply (topic 17806) said it was not supported outside the US, while the current docs list it.

2. In Japan, which payment methods accept app\_fee\_money on a Terminal checkout: card (including contactless and Apple Pay), FeliCa e-money (iD, QUICPay, transit IC), and QR codes (PayPay, etc.)? What happens if app\_fee\_money is sent with a method that is not supported: is the payment rejected, or is the fee silently dropped?

3. If we set device\_options.payment\_type to CARD\_PRESENT and attach app\_fee\_money, and set a different payment\_type without it, is that a supported pattern?

4. Is the application fee deducted from the seller’s proceeds in addition to Square’s own processing fee (for example 2.5% for cards)? Is it shown to the seller on their statement, and is there anything special for sellers in Japan?
