1. 개요
본 문서는 국내 개발자 들이 해외카드 및 해외 간편결제(페이팔, 앤텀) 에 대해 연동 후 테스트를 진행할 때 참고하도록 제공되는 가이드 입니다.
여기에서 제공되는 안내사항은 모두 관련 계약을 진행한 MID 의 test 키를 이용할 때만 가능하고, live 키를 사용할때는 동작되지 않습니다. 개발 연동 테스트 상점의 MID 로는 정상적으로 테스트 가능하지 않을 수 있습니다.
live 에서는 테스트를 하시려면, 실제 해당 결제수단이 있어야 가능합니다.
2. 결제 수단별 가이드
2-1. 토스페이먼츠 결제창을 사용하는 KRW, USD, JPY 해외카드 결제
아래와 같은 해외카드 결제창을 사용하는 경우에 테스트 하는 방법에 대해 설명합니다.
카드사 종류는 계약하신 내용에 따라 차이가 있을 수 있으며, 결제 통화 역시 계약에 따라 USD, JPY 로 표시 됩니다.
테스트 환경에서는 아래 3가지 더미 카드 번호를 이용해 테스트 결제가 가능합니다.
카드사 | 카드 번호 | 유효기간 |
비자 | 4242 4242 4242 4242 | 임의의 미래 날짜, yy/mm 형식 |
마스터 | 5555 5555 5555 4444 | 임의의 미래 날짜, yy/mm 형식 |
JCB | 3530 1113 3330 0000 | 임의의 미래 날짜, yy/mm 형식 |
•
혹시 해당 카드로 결제 시도 했을때 아래와 같이 에러가 발생한다면 토스페이먼츠 디스코드(https://discord.com/invite/fBreZafnTq) 나 techsupport@tosspayments.com 으로 해외카드 결제 계약을 진행한 MID 정보와 함께 문의 주시기 바랍니다.
2-2. 해외카드 키인 API
키인 API 를 이용해서 해외카드 결제를 연동하는 경우 테스트 하는 방법에 대해 설명합니다.
해외카드의 경우
•
카드번호
•
유효기간(월/년)
두가지 정보만 넣어서 결제를 진행합니다.
결제창과 동일하게 아래 더미카드 번호를 이용하면 테스트 결제를 할수 있습니다.
카드사 | 카드 번호 | 유효기간 |
비자 | 4242 4242 4242 4242 | 임의의 미래 날짜, yy/mm 형식 |
마스터 | 5555 5555 5555 4444 | 임의의 미래 날짜, yy/mm 형식 |
JCB | 3530 1113 3330 0000 | 임의의 미래 날짜, yy/mm 형식 |
2-2. 해외카드 빌링 API
빌링 API 를 이용해서 해외카드 결제를 연동하는 경우 테스트 하는 방법에 대해 설명합니다.
빌링도 키인과 동일하게
•
카드번호
•
유효기간(월/년)
두가지 정보만 넣어서 빌링키를 생성합니다.
키인과 동일하게 아래 더미카드 번호를 이용하면 빌링키를 발급 받을 수 있습니다.
카드사 | 카드 번호 | 유효기간 |
비자 | 4242 4242 4242 4242 | 임의의 미래 날짜, yy/mm 형식 |
마스터 | 5555 5555 5555 4444 | 임의의 미래 날짜, yy/mm 형식 |
JCB | 3530 1113 3330 0000 | 임의의 미래 날짜, yy/mm 형식 |
발급된 빌링키로 결제요청 API 를 호출하면 결제 완료 응답을 받을 수 있습니다.
2-2. PAYPAL USD 결제
페이팔이 제공하는 결제창을 통해 결제 연동하는 경우 테스트 하는 방법에 대해 설명합니다
테스트 키로 결제창을 여신 후에 아래 공용 계정을 이용해서 테스트가 가능합니다.
•
비밀번호: tosskim123!@#
2-3. 중국 및 동남아 결제
중국 및 동남아 결제수단이 제공하는 결제창을 통해 결제 연동하는 경우 테스트 하는 방법에 대해 설명합니다
중국 및 동남아 결제수단은 별도의 테스트 앱(Alipay+ Linker)을 제공하고 있습니다.
테스트 앱은 아래 링크를 통해 다운로드를 제공하고 있습니다.
해당 앱을 설치 하신후 직접 가입해서 사용하시거나 아니면 아래 공용 계정을 이용하면 됩니다.
•
비밀번호: tosskim123!@#
아래 테스트 앱 사용 방법을 참고해서 테스트 하시면 됩니다.
