해외결제 연동하기
✅ 토스페이먼츠에서 제공하는 해외결제 수단을 이해하고 비교할 수 있어요.
✅ 해외 카드 및 페이팔을 따로 또는 함께 연동하는 방법을 알 수 있어요.
토스페이먼츠 해외결제 비교
토스페이먼츠에서 지원하는 해외결제를 비교하고 내 상점에 맞는 서비스를 신청하세요.
| 해외 카드 | PayPal | |
|---|---|---|
| 설명 | 해외 카드는 대한민국이 아닌 국가에서 발급한 카드예요. 국내 카드사가 발급한 BIN에 속하지 않은 모든 카드를 해외 카드로 볼 수 있어요. | PayPal은 전 세계 200여 개 국가에서 4억 명 이상이 사용하는 글로벌 결제수단이에요. 부정거래 방지 시스템을 갖고 있기 때문에 믿고 쓸 수 있어요. |
| 결제수단 | 해외에서 발행된 VISA, MASTER, JCB, 유니온페이(중국은련) 카드 등 | 카드, 계좌 |
| 결제 통화 | KRW | USD |
| 지원 언어 | 한국어, 영어(결제창) | 영어, 프랑스어, 스페인어, 중국어 등 페이팔 지원 언어 |
| 차지백 | 고객의 차지백이 접수되면 소명자료를 제출하고 판결을 기다려야 해요. | 토스페이먼츠 차지백 대시보드를 통해 차지백을 효과적으로 대응할 수 있어요. |
해외 카드 결제는 추가 계약이 필요해요. 자세한 내용은 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
해외 카드는 계약 요청 후 영업일 2일 이내에 계약이 등록돼요. 계약 등록일로부터 영업일 10~14일 간 해외 카드 사용을 위한 추가 카드사 심사가 있어요. 일정에 참고해주세요.
PayPal 결제는 추가 계약이 필요해요. 자세한 내용은 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
토스페이먼츠로 PayPal을 사용하면 언어 장벽 없이 빠르게 계약이 가능합니다. 서류 미비 사항만 없다면, 영업일 기준 2~3 일 내에 계약이 등록돼요. 호스팅사에서는 PayPal을 사용할 수 없어요.
해외 카드 연동하기
해외 카드 계약을 완료한 뒤에 상점관리자의 결제위젯 어드민에 들어가면 기능 > 카드사 목록 메뉴에서 해외 카드를 확인할 수 있어요. 고객이 결제위젯에서 신용·체크카드를 선택하면 드롭다운 또는 버튼으로 해외 카드를 볼 수 있어요.
상점관리자 설정을 완료했다면 일반 결제위젯을 연동하는 방법과 똑같이 결제위젯을 연동하세요.
다국어 결제창 띄우기
토스페이먼츠 다국어 결제창은 영어, 중국어, 일본어를 지원해요. 고객이 해외 카드를 선택했을 때 다국어 결제창을 띄우고 싶다면, 결제를 요청할 때 useInternationalCard 파라미터를 true로 설정하세요.
다국어 결제창에서는 비자, 마스터, JCB, 유니온페이(중국은련)를 지원합니다. 테스트 환경에서는 비자, 마스터, JCB만 지원합니다. 해외에서 발급한 카드만 사용할 수 있습니다.
paymentWidget.requestPayment({
orderId: 'AD8aZDpbzXs4EQa-UkIX6',
orderName: '토스 티셔츠 외 2건',
successUrl: 'http://localhost:8080/success',
failUrl: 'http://localhost:8080/fail',
useInternationalCardOnly: true
})
해외 카드 강조하기
결제위젯에서 해외카드를 강조하고 싶다면 Pro 플랜의 특정 카드사 강조 기능을 사용하세요.
결제수단 목록에서 + 추가하기 버튼을 누르고 특정 카드사 메뉴에서 강조하고 싶은 해외 카드를 선택하세요. 선택한 카드는 다음 이미지와 같이 결제수단 목록에 따로 추가돼요.
해외 카드 테스트하기
해외 결제를 테스트할 수 있는 테스트용 카드 번호입니다. 유니온페이는 테스트 환경에서 사용할 수 없습니다.
| 카드사 | 카드 번호 | 유효기간 | 의미 |
|---|---|---|---|
| 비자 | 4242 4242 4242 4242 | 임의의 미래 날짜, yy/mm 형식 | 거래 승인 |
| 마스터 | 5555 5555 5555 4444 | 임의의 미래 날짜, yy/mm 형식 | 거래 승인 |
| JCB | 3530 1113 3330 0000 | 임의의 미래 날짜, yy/mm 형식 | 거래 승인 |
거래 실패 케이스를 테스트 하려면 테스트 코드 헤더 사용하기를 사용하세요.
PayPal 연동하기
상점관리자의 결제 UI 설정 메뉴로 들어가세요. 등록된 결제 UI의 이용서비스 중에 해외 간편결제가 있는지 확인하세요. UI 환경을 선택하고 기능 > 결제수단 목록 메뉴에 들어가면 PayPal을 확인할 수 있어요. PayPal 연동하기 가이드에서 자세한 연동 과정과 주의점을 알아보세요.
PayPal + 해외 카드 연동하기
결제위젯에 PayPal과 다른 결제수단을 함께 사용하려면 결제위젯 Pro 플랜의 커스텀 결제수단 기능을 사용해야 돼요.
먼저 상점관리자의 결제수단 목록에서 + 추가하기 버튼을 누르고 커스텀 결제수단 메뉴에서 이름을 'Card'로 입력하고 key를 CARD로 입력하세요. 결제위젯에 해외 카드 버튼이 추가된 걸 보실 수 있어요.
이제 해외 카드를 토스페이먼츠 결제창으로 직접 결제위젯에 연동할게요. 아래 코드와 같이 PayPal 결제위젯을 렌더링하고, 'Card' 결제 이벤트를 수신하는 콜백에 카드 결제를 연동하세요. 콜백에서 해외 카드 결제의 상점아이디(MID)에 연결된 클라이언트 키를 추가해야 해요.
/* PayPal 결제위젯 연동하기*/
const clientKey = "{PAYPAL_CLIENT_KEY}" // PayPal 상점아이디(MID)에 연결된 클라이언트 키
const customerKey = ""
const paymentWidget = PaymentWidget(clientKey, customerKey)
const paymentMethods = paymentWidget.renderPaymentMethods(
"#payment-method",
{
value: 23.31,
currency: "USD",
country: "US"
},
{ variantKey: "PAYPAL" } // PayPal이 추가된 결제 UI의 variantKey
)
/*해외 카드 커스텀 결제수단으로 연동하기*/
paymentMethods.on("customRequest", paymentMethodKey => {
if (paymentMethodKey === "CARD") {
var clientKey = "{CARD_CLIENT_KEY}" // 해외 카드 상점아이디(MID)에 연결된 클라이언트 키
var tossPayments = TossPayments(clientKey)
tossPayments.requestPayment("카드", {
amount: 10000,
orderId: "",
orderName: "테스트 결제",
customerName: "김토스",
successUrl: "http://localhost:8080/success",
failUrl: "http://localhost:8080/fail",
useInternationalCardOnly: true // 다국어 결제창 열기
})
}
})
- 결제위젯은 PayPal 상점아이디(MID)와 연결된 클라이언트 키, 시크릿 키를 사용하세요.
- 해외 카드는 해외 카드 계약이 완료된 상점아이디(MID)와 연결된 클라이언트 키, 시크릿 키를 사용하세요.
영문 이용약관 추가하기
해외 고객에게 영문으로 이용약관을 보여주고 싶다면, 상점관리자에서 영문 이용약관을 추가하세요.
이용약관을 렌더링하는 메서드에서 영문 이용약관의 variantKey를 파라미터로 설정하세요.
const paymentAgreement = paymentWidget.renderAgreement(
'#agreement',
{ variantKey: `AGREEMENT-EN` }
)