토스페이먼츠에 가입하면 개발자센터에서 테스트 API 키를 확인할 수 있습니다. 라이브 API 키는 계약이 필요합니다.
계약 문의는 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 해주세요.
아래 테스트 키로 바로 연동을 시작해보세요. 토스페이먼츠에 로그인했다면 아래 키 값이 개발자센터에 있는 테스트 키 값이고, 테스트 결제내역을 확인할 수 있습니다.
클라이언트 키는 브라우저에서 토스페이먼츠 SDK를 연동할 때 사용합니다.
test_ck_D5GePWvyJnrK0W0k6q8gLzN97Eoq
시크릿 키는 토스페이먼츠 API를 호출할 때 사용합니다. 시크릿 키를 사용하는 방법은 인증 가이드에서 확인하세요.
test_sk_zXLkKEypNArWmo50nX3lmeaxYG5R
시크릿 키는 노출되면 안 됩니다. GitHub, 클라이언트 코드 등 외부에서 볼 수 있는 곳에 추가하지 마세요.
로그인을 하지 않고 문서에 있는 테스트 키를 사용하고 있다면 결제 내역을 확인할 수 없습니다.
키 종류 | 설명 | 결제 여부 | 발급 방법 | 결제 내역 | 형식 |
---|---|---|---|---|---|
개발자용 테스트 | 모든 결제수단을 테스트할 수 있습니다. | X | 회원가입 | 개발자센터 테스트 결제내역 | test_ 로 시작하는 문자열 |
상점용 테스트 | 라이브 환경과 똑같이 계약한 결제수단만 테스트할 수 있습니다. | X | 계약 | 개발자센터 테스트 결제내역 | test_ 로 시작하는 문자열 |
라이브 | 실제 서비스에 사용하세요. | O | 계약 | 상점관리자 | live_ 로 시작하는 문자열 |
상점용 테스트 키 및 라이브 키는 상점아이디(MID)로 계약한 결제수단만 연동할 수 있습니다. 예를 들어, 카드 결제만 계약했는데 가상계좌 결제창을 호출하면 에러가 납니다.
상태 코드 | 에러 코드 | 에러 메시지 |
---|---|---|
400 | INVALID_CLIENT_KEY | 잘못된 클라이언트 연동 정보 입니다. |
400 | INVALID_API_KEY | 잘못된 시크릿키 연동 정보 입니다. |
401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. |
401 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. : 를 포함해 인코딩해주세요. |