다통화 결제

1. 개요

본 문서는 토스페이먼츠에서 USD 및 JPY 통화로 결제 요청하는 법에 대해 안내합니다. 요청 이후 결제승인 Flow는 기존 국내 결제와 동일하게 승인API(링크)를 호출해주시면 됩니다.

2. 사전 준비

계약전에는 아래 정보로 테스트해보실 수 있습니다.

## 결제창
clientKey: test_ck_ALnQvDd2VJYmLewOane3Mj7X41mN
secretKey : test_sk_5OWRapdA8dYwzX15xxA3o1zEqZKL 

##결제위젯 
widgetClientKey : test_gck_docs_Ovk5rk1EwkEbP0W43n07xlzm
widgetSecretKey : test_gsk_docs_OaPz8L5KdmQXkzRz3y47BMw6
variantKey : FOREIGN-PAY

MID는 각 통화별로 구분되어야 합니다. 기존 국내 결제 수단을 사용하던 MID가 있더라도 USD, JPY 모두 도입 시 추가로 2개의 MID가 필요합니다.

3. 연동 특이사항

다통화 결제는 토스페이먼츠 결제창 및 결제위젯을 통해 연동할 수 있습니다.

A. 결제창

요청한 통화(currency) 기반으로 결제창이 열립니다. (예: JPY > 일본어) 이후 결제창에서 언어 변경이 가능하며, 한국어/영어/일본어/중국어를 지원합니다.
국내 카드는 토스페이먼츠 결제창을 거치지 않고 카드사를 직접 호출할 수 있지만, 해외 카드는 VISA/MASTER 등 카드사를 직접 호출할 수 없으며 반드시 토스페이먼츠 결제창을 거쳐야 합니다.

B. 결제위젯

결제 위젯은 동일한 통화를 사용하는 결제 수단끼리만 하나의 variantKey(= UI)에 구성할 수 있습니다.

<aside> 💡

KRW : 국내 카드사, 가상계좌, 계좌이체, 핸드폰, 간편결제(토스페이, 카카오 네이버..) 등

USD : 해외 카드, PAYPAL, Alipay 및 동남아 간편결제수단

JPY : 해외 카드 (일본 간편결제 수단은 추후 추가 예정)

** 해외간편결제+다통화 카드를 동일한 위젯에서 사용하기 위해서는 하나의 MID에 청약되어야 합니다.

</aside>

결제 위젯에서 각 브랜드사를 선택한 후 결제를 요청하면, 이후 호출되는 결제창에서는 선택한 브랜드사가 고정됩니다.