API 키

토스페이먼츠에 가입하면 개발자센터에서 테스트 API 키를 확인할 수 있습니다. 라이브 API 키는 계약이 필요합니다.

계약 문의는 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 해주세요.

API 키 종류

아래 테스트 키로 바로 연동을 시작해보세요. 토스페이먼츠에 로그인했다면 아래 키 값이 개발자센터에 있는 테스트 키 값이고, 테스트 결제내역을 확인할 수 있습니다.

클라이언트 키는 브라우저에서 토스페이먼츠 SDK를 연동할 때 사용합니다.

test_ck_D5GePWvyJnrK0W0k6q8gLzN97Eoq

시크릿 키는 토스페이먼츠 API를 호출할 때 사용합니다. 시크릿 키를 사용하는 방법은 인증 가이드에서 확인하세요.

test_sk_zXLkKEypNArWmo50nX3lmeaxYG5R

시크릿 키는 노출되면 안 됩니다. GitHub, 클라이언트 코드 등 외부에서 볼 수 있는 곳에 추가하지 마세요.

로그인을 하지 않고 문서에 있는 테스트 키를 사용하고 있다면 결제 내역을 확인할 수 없습니다.

키 종류	설명	결제 여부	발급 방법	결제 내역	형식
개발자용 테스트	모든 결제수단을 테스트할 수 있습니다.	X	회원가입	개발자센터 테스트 결제내역	`test_`로 시작하는 문자열
상점용 테스트	라이브 환경과 똑같이 계약한 결제수단만 테스트할 수 있습니다.	X	계약	개발자센터 테스트 결제내역	`test_`로 시작하는 문자열
라이브	실제 서비스에 사용하세요.	O	계약	상점관리자	`live_`로 시작하는 문자열

상점용 테스트 키 및 라이브 키는 상점아이디(MID)로 계약한 결제수단만 연동할 수 있습니다. 예를 들어, 카드 결제만 계약했는데 가상계좌 결제창을 호출하면 에러가 납니다.