Skip to content
이 내용이 도움이 되었나요?

콘솔 가이드

1. 계약하기

토스페이를 사용하려면 먼저 사전 서류를 준비하고 서면 계약을 체결해야 해요.
계약이 완료되어야 실제 결제를 연동할 수 있어요.

진행 절차

  1. 채널톡으로 정보 입력
  2. 1차 검토: 입력한 정보를 바탕으로 토스페이팀이 1차 검토를 진행해요.
  3. 추가 안내: 추가 확인이 필요한 경우, 청약 담당자 메일로 별도 안내해 드려요.
  4. 청약 서류 제출: 청약 서류를 작성해 제출해 주세요. 내부 검수를 거친 뒤 토스페이 키값을 발급해요.

키 발급까지는 영업일 기준 7~14일 정도 걸려요.
서비스 일정에 맞춰 여유 있게 신청해 주세요.

2. 설정하기

계약이 완료되면 메일로 토스페이 키값을 받아요.
발급받은 키값을 앱인토스 콘솔에 등록해야 실제 연동이 가능해요.

키 등록 경로

워크스페이스 → 연동 키 → 등록 버튼 선택 → 가맹점 키 입력

테스트용 API 키

테스트용 키도 제공돼요 → sk_test_w5lNQylNqa5lNQe013Nq

  • 테스트 키는 결제 생성까지만 가능해요.
  • 실제 승인 처리는 할 수 없어요.

꼭 확인해 주세요

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