토스페이먼츠 설정 가이드
토스페이먼츠에서 결제 연동에 필요한 API 키를 발급합니다.
개요
| 항목 | 내용 |
|---|---|
| 예상 소요시간 | 약 1-3일 (심사 포함) |
| 필요한 것 | 사업자등록증, 통장 사본 |
| 결과물 | Client Key, Secret Key |
사전 준비
- 사업자등록증 사본
- 정산 받을 통장 사본
- 서비스 URL이 확정되어 있어야 합니다
경고
토스페이먼츠는 사업자만 가입 가능합니다.
Step 1: 토스페이먼츠 가입
- 토스페이먼츠에 접속합니다
- 가입하기를 클릭합니다
- 사업자 정보를 입력하고 가입을 완료합니다
Step 2: 상점 등록
- 토스페이먼츠 개발자센터에 접속합니다
- 로그인 후 내 개발정보를 클릭합니다
- 상점 정보를 등록합니다:
- 상점 이름
- 서비스 URL
- 업종 정보
Step 3: API 키 확인
- 내 개발정보 > API 키 섹션을 확인합니다
- 다음 두 가지 환경의 키가 제공됩니다:
- 테스트 키: 개발/테스트용 (test_로 시작)
- 라이브 키: 실서비스용 (live_로 시작)
- 각 환경에 Client Key와 Secret Key가 있습니다
위험
Secret Key는 절대 외부에 노출하지 마세요! Client Key는 프론트엔드에서 사용되지만, Secret Key는 서버에서만 사용해야 합니다.
Step 4: 심사 요청
라이브 키를 사용하려면 심사가 필요합니다:
- 필요 서류를 업로드합니다:
- 사업자등록증
- 통장 사본
- 심사를 요청합니다
- 심사 완료까지 1-3 영업일 소요됩니다
전달해야 할 정보
아래 정보를 개발팀에 안전하게 전달해주세요:
테스트 환경 (개발용)
- 테스트 Client Key
- 테스트 Secret Key
라이브 환경 (실서비스용, 심사 완료 후)
- 라이브 Client Key
- 라이브 Secret Key
Secret Key는 매우 민감한 정보이므로 반드시 안전한 방법으로 전달해주세요.
자주 묻는 질문
Q: 테스트 키로 실결제가 되나요?
A: 아니요, 테스트 키로는 실제 결제가 이루어지지 않습니다. 개발 및 테스트 목적으로만 사용됩니다.
Q: 심사에 얼마나 걸리나요?
A: 일반적으로 1-3 영업일 소요됩니다. 서류에 문제가 있으면 추가 시간이 걸릴 수 있습니다.
Q: 수수료는 얼마인가요?
A: 결제 수단과 업종에 따라 다릅니다. 토스페이먼츠에 직접 문의하시거나 개발팀에서 안내드리겠습니다.