콘솔 가이드
1. 계약하기
토스페이를 사용하려면 먼저 사전 서류를 준비하고 서면 계약을 체결해야 해요.
계약이 완료되어야 실제 결제를 연동할 수 있어요.
진행 절차
- 채널톡으로 정보 입력
- 1차 검토: 입력한 정보를 바탕으로 토스페이팀이 1차 검토를 진행해요.
- 추가 안내: 추가 확인이 필요한 경우, 청약 담당자 메일로 별도 안내해 드려요.
- 청약 서류 제출: 청약 서류를 작성해 제출해 주세요. 내부 검수를 거친 뒤 토스페이 키값을 발급해요.
키 발급까지는 영업일 기준 7~14일 정도 걸려요.
서비스 일정에 맞춰 여유 있게 신청해 주세요.
2. 설정하기
계약이 완료되면 메일로 토스페이 키값을 받아요.
발급받은 키값을 앱인토스 콘솔에 등록해야 실제 연동이 가능해요.
키 등록 경로
워크스페이스 → 연동 키 → 등록 버튼 선택 → 가맹점 키 입력
테스트용 API 키
테스트용 키도 제공돼요 → sk_test_w5lNQylNqa5lNQe013Nq
- 테스트 키는 결제 생성까지만 가능해요.
- 실제 승인 처리는 할 수 없어요.


꼭 확인해 주세요
- 기존에 사용하던 일반 토스페이 키값이 아니라, 앱인토스 전용 토스페이 키값을 입력해야 해요.
- 잘못된 키를 입력하면 결제 요청 시 에러를 발생시켜요.