Version 1
배포 체크리스트
SDK v1은 더 이상 업데이트되지 않습니다. 토스페이먼츠 SDK v2 연동을 추천합니다.
연동을 마쳤다면 결제 시스템을 라이브 환경에서 사용할 준비가 됐는지 다음 체크리스트로 확인하세요.
* 이 체크리스트는 기본적인 사항만 다룹니다. 개별 기능에 대한 상세한 테스트 케이스를 추가로 준비하고 검증하세요.API 키·API 버전 확인
코드에 추가한 API 키가 내 상점의 라이브 키인지 확인하세요. 라이브 키는 앞에 live_가, 테스트 키는 앞에 test_가 붙어 있어요. 왼쪽 메뉴 상단에 선택된 내 상점아이디(MID)도 다시 한번 확인하세요.
결제수단 심사 확인
휴대폰 결제를 지원하려면 각 이동 통신사 심사를 통과해야 해요. 각 이동 통신사의 결제가 모두 잘 동작하는지는 결제수단별 테스트를 참고해서 테스트해보세요.
* 주요 이동 통신사: SKT, LGT, KT
상품권 결제를 지원하려면 모든 종류의 상품권 심사를 모두 통과해야 해요. 각 상품권 결제가 모두 잘 동작하는지는 결제수단별 테스트를 참고해서 테스트해보세요.
* 상품권: 문화상품권, 도서문화상품권, 게임문화상품권
결제수단별 테스트
공통
다음 흐름이 모두 문제없이 진행되는지 확인하세요. 결제 완료, 즉 승인에 성공하면 HTTP 200 OK와 Payment 객체를 받습니다.
1️⃣ 결제창 실행·결제 UI 그리기
- 결제창이 실행되지 않거나 결제 UI가 나타나지 않는다면 브라우저 개발자 도구로 JavaScript 에러가 있지 않은지, 네트워크 탭에서 호출이 실패하는 요청이 있는지 확인하세요.
2️⃣ 선택한 결제수단(카드사 자체창·앱카드 등) 실행
- 모바일 웹 환경에서 카드사·간편결제사 앱이 없다는 메시지가 돌아오고 더 이상 진행되지 않거나, 모바일 앱 환경에서 자동으로 앱스토어나 플레이스토어로 이동할 때 카드사나 간편결제사 앱이 다운로드 되어 있는지 확인하세요. 모바일 앱에서 웹뷰를 사용한다면 앱 스킴 리스트와 관련 코드가 제대로 추가되어 있는지 확인하세요.
3️⃣ 상점 브라우저 페이지·상점 앱으로 이동
- 결제 결과에 따라 페이지 이동이 되지 않을 때
successUrl과failUrl이 올바르게 들어가 있는지 확인하세요.
4️⃣ 결제 완료
-
결제 승인 API가 제대로 요청되었는지 확인하세요.
-
결제 완료 후 페이지 이동까지 구현했다면 결제 결과에 따라 성공 혹은 실패 페이지로 이동하는 흐름도 확인하세요.
결제 취소를 한 뒤 Paymen.status가 CANCELED인지, Payment 객체의 cancels 필드에 취소 객체가 추가됐는지 확인하세요.
부분 취소를 여러 번 한 뒤 다음과 같이 Payment.cancels 필드에 취소 객체가 여러 개 돌아왔는지 확인하세요.
카드·간편결제
카드 결제의 할부 개월 수와 무이자 여부를 선택했을 때 결제 금액 및 할인 정보가 올바르게 변경됐는지 확인하세요. 결제창 SDK 파라미터로 적용했다면 값이 올바르게 적용되었는지 확인하세요.
계좌이체
Payment.cashReceipts.receiptUrl의 주소로 현금영수증이 발행됐는지 확인할 수 있어요.
가상계좌
개발자센터의 웹훅 목록에서 이벤트 타입이 DEPOSIT_CALLBACK인 웹훅이 등록되어 있는지 확인하세요. 웹훅 이벤트를 등록하는 방법은 웹훅 가이드에서 확인할 수 있어요.
개발자센터의 웹훅 목록에 웹훅이 등록되어 있다면 입금됐을 때, 즉 가상계좌 결제 상태가 바뀌었을 때 웹훅 URL로 알림이 발송돼요.
아래와 같은 이벤트 본문이 등록한 웹훅 URL로 전송됐는지 확인하세요. 이벤트 본문의 secret 값이 결제 승인 응답으로 돌아온 Payment 객체의 secret 값과 같은지도 확인하세요. 값이 같다면 토스페이먼츠 서버에서 돌아온 올바른 요청이에요.
현금영수증은 구매자가 가상계좌에 입금한 뒤에 발급돼요. 입금 전에는 현금영수증을 확인할 수 없어요. 테스트 환경에서는 개발자센터의 테스트 거래내역 페이지에서 가장 오른쪽 컬럼의 입금처리・취소 기능으로 실제 동작과 동일하게 테스트할 수 있어요.
입금 후에는 Payment.cashReceipts.receiptUrl의 주소로 현금영수증이 발행됐는지 확인할 수 있어요.
플랫폼·브라우저 환경 테스트
상점에서 지원하는 모든 플랫폼·브라우저 환경에서 각 결제수단의 결제 흐름이 문제없이 동작하는지, 결제와 결제 취소가 성공적으로 진행되는지 확인하세요.
Chrome, Edge, Firefox, Safari, Whale 환경 각각에서 결제 흐름이 정상적으로 작동하는지 확인하세요. 몇 가지 브라우저만 테스트하면 다른 브라우저에서 발생할 수 있는 문제를 놓칠 수 있어요.
모바일 앱에서 Android와 iOS 환경 각각에 대해 결제 흐름이 정상적으로 이루어지는지, 카드사 앱 및 백신 앱으로의 이동이 잘 이루어지는지 확인하세요.