Overview
시작 전에 확인하세요
PG 가맹점 계약은 사업자등록이 전제입니다. 개인 사업자도 가능하지만 업종에 따라 추가 서류(통신판매업 신고증·의료·금융 관련 인허가)가 필요할 수 있습니다. 테스트 키로 먼저 연동을 끝내고, 실서비스 키는 가맹점 심사 완료 후 발급됩니다.
사업자등록 필수
개인·법인 모두 가능.
통신판매업 신고
일반 판매업은 필수 (서울 구청).
정산 통장
사업자명과 일치한 계좌 준비.
서비스 URL/앱
심사 대상이 실재해야 함.
Step by Step
단계별 가이드
DEV FIRST
테스트 키로 먼저 연동
계약 전에 테스트 키로 결제 플로우를 완성해두면 출시 일정이 당겨집니다.
- docs.tosspayments.com에 바로 공개되어 있는 테스트 키 사용
- 결제 위젯 / 결제 창 / 브랜드페이 등 방식 선택
- 성공/실패/취소 콜백 URL 구현
- 국내 카드·해외 카드·계좌이체·간편결제 테스트 가능
APPLY
가맹점 신청서 작성
tosspayments.com에서 가맹점 계약 신청.
- 상호·대표자명·사업자등록번호·업종
- 판매 품목 및 예상 월 거래액
- 서비스 URL (출시 전이면 "준비 중" + 스크린샷 별첨 가능)
- 정산 계좌 정보 (사업자명 일치)
DOCS
필요 서류 업로드
기본 + 업종별 추가 서류.
- 기본: 사업자등록증·대표자 신분증·통장 사본
- 일반 판매: 통신판매업 신고증
- 의료·의약품: 관련 허가증 / 면허증
- 음식점: 영업신고증
- 서비스 스크린샷 2–3장 (결제 흐름 확인용)
FEE
수수료 협의
카드·간편결제별 수수료율을 계약서에서 확인.
- 일반 카드: 2.5–3.5% 수준 (거래액·업종별 상이)
- 간편결제(카카오페이·네이버페이 등): 추가 수수료
- 정산 주기: D+1 (다음 영업일) · D+3 · D+7 중 선택
- 월 거래액이 크면 수수료 인하 협상 가능
REVIEW
심사 & 승인
영업일 기준 2~5일 소요.
- 서류 보완 요청은 이메일로 발송
- 일부 업종(보험·투자·게임·주류)은 추가 심사
- 승인 시 가맹점 관리자 계정 발급
- 계약서 전자서명(카카오 인증 등)으로 체결
LIVE KEYS
실서비스 키 발급
승인 완료 후 실제 결제가 가능한 키를 발급받습니다.
- 상점 관리자 페이지 > API 키
- 클라이언트 키: 프론트 결제창 호출용 (공개 OK)
- 시크릿 키: 서버 승인·취소 호출용 (절대 노출 금지)
- .env로 분리하고 서버에서만 사용
- 테스트 키와 실서비스 키는 prefix로 구분됨 (test_* / live_*)
WEBHOOK
웹훅 (Webhook) 등록
결제 상태 변경을 서버에서 즉시 수신.
- 상점 관리자 > 개발자 센터 > 웹훅
- 이벤트: PAYMENT_STATUS_CHANGED, CANCEL_STATUS_CHANGED 등
- 엔드포인트 URL 등록 (HTTPS 필수)
- 서명 검증(Signature) 로직 구현 — 위조 방지
SETTLEMENT
정산·세금계산서 자동화
정산 내역과 세금계산서 확인·다운로드.
- 정산 내역: 상점 관리자 페이지에서 일/월별 확인
- 세금계산서는 토스페이먼츠에서 자동 발행
- 현금영수증은 결제 승인 시 자동 처리 가능
- 엑셀 다운로드 또는 API로 정산 자동화
Pitfalls
자주 막히는 부분
서비스 미완성 상태로 심사 요청
최소한 결제 플로우 스크린샷이나 테스트 URL이 있어야 통과됩니다. "준비 중"만으로는 반려되기 쉬워요.
정산 계좌 명의 불일치
사업자등록증의 상호·대표자명과 통장 명의가 달라 반려되는 경우가 많습니다.
시크릿 키 프론트 노출
결제 승인·취소 API는 반드시 서버에서 호출해야 합니다. 프론트에서 직접 호출하면 모든 거래가 조작 가능.
웹훅 서명 검증 누락
웹훅 엔드포인트에 누구나 POST를 보낼 수 있습니다. 서명 검증 없이 상태를 믿으면 결제 우회 취약점.
인앱결제 정책
iOS·Android 앱에서 디지털 상품 결제는 각 스토어의 인앱결제만 허용. 외부 PG 사용 시 앱 거부 위험.