Custom Default language in accepting payments overseas
Hello team, could we change the default language in checkout loadTossPayments, currently it's showing English as default, and the user has to change it manually.

17 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
Have u just started the integration?
Which SDK version are you using?
Thanks for your reply.
Yes, we’ve just recently started the integration and are still in the initial release phase.
We are using the JavaScript v2 SDK: @tosspayments/tosspayments-sdk
Here's the docs we follow
https://docs.tosspayments.com/guides/v2/payment-window/integration-international
다국어 결제창 연동하기 | 토스페이먼츠 개발자센터
VISA, Mastercard 등 해외 카드를 사용하는 구매자를 위한 다국어 결제창입니다. 한국어, 영어, 중국어, 일본어를 지원하고 있습니다.
Hello team,
Is it correct that Toss Payments currently uses English as the default language for overseas payment windows, and that users must manually change the language if they prefer a different one? I would appreciate clarification on how language defaults and switching work for international payments.
Thank you.
@주식회사 삶
No, there is actually a way to set the default language — I’ll share the guide with you in a moment.
Got it, thanks a lot!
Use the v1 SDK (International Payment Window) — it’s functionally very close to v2, so it’s fine to use.
Keep all other parameters the same, and add the language parameter when calling requestPayment:
language: EN | JA | ZH (English, Japanese, Chinese)
Docs: https://docs.tosspayments.com/guides/payment/international-window
다국어 결제창 | 토스페이먼츠 개발자센터
해외 카드를 사용하는 구매자를 위해 다국어 결제창을 호출하는 방법을 알려드려요.
Thanks for sharing, we will check it.
Are you planning to add a customizable default language option in v2?
If so, could you share the expected timeline for when this feature will be supported?
We currently need to process payments in Japan, and having the checkout page displayed in Japanese is very important for our users. We would prefer to rely on the stable, actively maintained version of the checkout widget (v2), so language customization would be a valuable feature for us.
Oh, are you planning to use the checkout widget?
What payment methods are you trying to support right now?
Good morning,
Yes, we want to accept credit card payments, these ones look good for now.

This isn’t actually the payment widget, so I think it should be fine to follow the guide I gave you — do you think there might be any issues?
We followed the guide you shared, but adding language = "JA" in v1 didn’t work on our side.
Additionally, I’d like to check whether you’re planning to add a default-language option to v2. If so, when do you expect to support it?
We are planning to support. but dont have clearfy duedate yet
could you check above sample and let me know it works?
Got it, thanks for letting me know!
Thanks!
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.