목차

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

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

개발자센터 API 키 페이지

API 키 종류

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

클라이언트 키

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

test_ck_D5GePWvyJnrK0W0k6q8gLzN97Eoq

시크릿 키

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

test_sk_zXLkKEypNArWmo50nX3lmeaxYG5R

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

테스트 및 라이브 키

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

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

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

API 키 에러

상태 코드에러 코드에러 메시지
400INVALID_CLIENT_KEY잘못된 클라이언트 연동 정보 입니다.
400INVALID_API_KEY잘못된 시크릿키 연동 정보 입니다.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.
401INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. : 를 포함해 인코딩해주세요.
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    디스코드 채팅|이메일 보내기