시작하기
이용 사례
실서비스에서 검증된 결제 흐름을 업종별 시나리오로 정리했습니다.
청구서 기반 서비스 — 학원·교습소·회비
콘솔 또는 청구서 API로 매월 청구서를 보냅니다. 고객은 알림톡(또는 문자)의 링크로 결제 페이지에 들어와 카드·카카오페이로 납부하고, 수납 상태는 콘솔 발송·수납 내역에서 확인합니다.
- 예약·정기 발송: 매월 1일 09:00 같은 반복 청구는 콘솔의 정기 발송으로 자동화합니다.
- 미납 고객에게는 재발송(같은 청구서, 같은 링크)을 씁니다. 재발송도 포인트가 차감됩니다.
- 카카오톡을 쓰지 않는 고객은 발송 수단을 문자 또는 알림톡 실패 시 문자로 지정합니다.
콘텐츠·구독형 서비스 — 이용권 즉시 개통
결제 링크 API로 결제를 만들고, 고객을 REDIRECT_URL로 바로 이동시킵니다(UX 패턴 A). 결제 완료 콜백을 받으면 searchPayment로 APPROVE_COMPLETE를 확인한 뒤 이용권을 엽니다. 콜백은 중복·지연될 수 있으므로 이용권 개통은 멱등하게 1회만 처리합니다.
- 구독 갱신은 만료 전 결제 링크를 재발급해 문자·알림톡으로 보내는 방식으로 운영합니다.
원격·비대면 판매 — 전화 상담 후 결제
상담원이 콘솔에서 청구서를 보내거나, 귀사 CRM이 청구서 API를 호출합니다. 데스크톱 사용자에게는 "휴대폰으로 결제 링크를 보냈어요" 대기 화면을 띄우고 3초 간격으로 상태를 폴링해 완료를 감지합니다(UX 패턴 B).
상품 주문 — 교재·굿즈(SHOP)
결제 생성 시 orderType: "SHOP"과 ITEMS[](품목명·단가·수량·출판사·이미지)를 함께 보내면 결제 페이지에 품목 표가 표시됩니다. 콜백에는 ORDER_TYPE: "SHOP"이 담깁니다. 결제 생성 API
플랫폼 — 여러 판매자의 결제 중개
판매자마다 STORE_CODE를 발급받아 정산·환불 책임을 분리합니다. 플랫폼은 하나의 PLATFORM_CODE로 모든 판매자의 결제를 생성하되, 주문마다 해당 판매자의 STORE_CODE를 넣습니다. 플랫폼·다중 가맹점
문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.