환경 설정하기

테스트 환경 주의점, 방화벽 설정, 지원 플랫폼 및 브라우저를 알아보세요.

테스트 환경

토스페이먼츠는 개발자의 연동 편의를 위해 라이브 환경과 비슷한 테스트 환경을 제공하고 있어요.

하지만 테스트 환경에서는 카드 번호와 같은 실제 결제 정보를 입력해도, 결제는 가상으로 승인돼요. 따라서 테스트 환경에서는 결제가 승인되어도 실제 결제수단에서 돈이 출금되지 않아요.

테스트 환경과 라이브 환경이 다른 점은 아래 표에서 자세히 확인하세요.

카드

간편결제

가상계좌

테스트 환경에서는 가상계좌번호 앞에 'X'가 붙습니다.
테스트 환경에서 발급된 계좌로 직접 입금할 수 없지만 테스트 결제내역 메뉴에서 입금처리를 할 수 있습니다.
개발 연동 체험 상점의 테스트 키로 연동하면 가상계좌 입금 안내 문자가 발송되지 않습니다. 토스페이먼츠 전자결제 계약 이후에 확인할 수 있는 테스트 키로는 가상계좌 안내 문자가 발송됩니다.

영수증

자동결제(빌링)

계좌이체

계좌번호, 비밀번호, 계좌 소유주 이름, 보안카드와 OTP 정보를 가상의 값으로 넣어 테스트할 수 있습니다. 다만 사용자의 공동 인증서는 실제로 인증이 되어야 합니다.

게임 문화 상품권

정산

지급대행

테스트 환경에서 잔액조회 API를 호출하면 응답으로 availableAmount만 돌아옵니다.
테스트 환경에서는 유효한 사업자번호로 법인사업자(CORPORATE) 셀러만 등록할 수 있어요. 셀러의 상태가 KYC_REQUIRED로 바뀔 수는 있지만 테스트 KYC 수행이 불가능하기 때문에 APPROVED 상태로 바뀔 수는 없습니다.
지급대행 요청 API를 라이브 환경에서 테스트하면 수수료가 부과됩니다.

API 요청 제한

에러 대응을 위해 테스트 환경에서 API 에러를 재현하고 싶을 수도 있는데요. 아래 TossPayments-Test-Code API 헤더를 사용하면 토스페이먼츠에서 일어나는 모든 에러를 테스트 환경에서도 라이브 환경과 똑같이 재현할 수 있어요.

아래 예시는 결제 승인 API에서 잔액 부족 또는 한도초과 에러 REJECT_CARD_PAYMENT를 제현하고 있어요. 예시로 사용 방법을 자세히 알아볼게요.

그럼 아래와 같이 테스트한 에러 코드의 에러 객체가 응답으로 돌아옵니다.

테스트 환경에서 일어난 결제 내역은 개발자센터에서 자세히 확인할 수 있어요. 라이브 환경의 결제내역은 상점관리자에서 확인해주세요.

개발자센터에 로그인하고 내 테스트 결제내역 메뉴로 이동하세요.
날짜 별, 결제수단 별로 결제내역을 조회할 수 있어요.
가상계좌 결제는 가장 오른쪽 칼럼에서 결제를 취소하거나 가상계좌 입금을 처리할 수 있어요.
- '취소' 를 선택하면 결제 취소 API를 호출하지 않고 테스트 결제를 취소할 수 있어요.
- '입금처리' 를 선택하면 가상계좌에 입금되는 액션을 테스트할 수 있어요.

토스페이먼츠는 구매자의 결제 정보와 개인 정보를 보호하기 위해 HTTPS 통신과 TLS 버전 1.2 이상만 지원해요. 서버에서 아래 토스페이먼츠 IP 주소를 허용해주세요. 더 자세한 내용은 방화벽 가이드에서 확인하세요.

토스페이먼츠 SDK가 지원하는 플랫폼·브라우저 환경이에요. 토스페이먼츠 결제 서비스를 원활하게 이용하려면 최신 버전의 브라우저를 사용하는 것을 권장해요. 최신 브라우저는 더 안전하고 안정적이기 때문에 결제 오류를 최소화할 수 있습니다.

플랫폼 환경	브라우저 환경
데스크톱 브라우저	- Chrome 72 이상 - Edge 79 이상 - Firefox 64 이상 - Safari 13 이상 - Whale 1.6.81.8 이상
모바일 웹	Chrome, Safari, 삼성 인터넷
모바일 앱	Android, iOS