시작하기
내 상황에 맞는 방식 고르기
SDK만 받으면 되나요?" — 콘솔·결제 링크 API·청구서 API 중 무엇이 필요한지 30초 안에 정합니다.
상황별 추천
| 상황 | 추천 경로 | 개발 | 준비물 |
|---|---|---|---|
| 학원비·회비·수리비처럼 고객에게 청구서를 보내고 수납만 하면 된다 | 가맹점 콘솔 | 없음 | 사업자등록증, 정산계좌, 발송 포인트 |
| 내 웹·앱 안에서 결제 버튼을 누르면 결제창으로 보내고 싶다 | 결제 링크 API | 서버 API 4개 | PLATFORM_CODE·STORE_CODE·API_KEY, HTTPS 콜백 서버 |
| 전화·상담 후 결제 링크만 문자로 보내고 싶다 | 결제 링크 API(링크 발급) 또는 청구서 API(발송까지) | 서버 API 1~4개 | 위와 같음 |
| 내 시스템(ERP·CRM·예약)에서 청구서를 자동 발송하고 수납을 확인하고 싶다 | 청구서 API | 서버 API 1~3개 | 가맹점 계정(접근 토큰), 발송 포인트 |
| 여러 판매자·입점사의 결제를 중개하는 플랫폼이다 | 플랫폼·다중 가맹점 | 결제 링크 API + 가맹점 매핑 | 판매자별 STORE, 계약·정산 구조 |
| 매장에서 카드단말기로 받고 싶다 | 단말 온보딩 | 없음 | CAT ID 또는 신규 발급 |
"SDK를 주면 되나요?"에 대한 답
- 콘솔만 쓰는 가맹점에게는 SDK가 필요 없습니다. 계정과 포인트만 있으면 됩니다.
- 결제 링크 API와 청구서 API는 공식 SDK(Node.js·Python)로 시작하는 것이 가장 빠릅니다. 다른 언어는 OpenAPI 규격으로 클라이언트를 만들거나 직접 호출합니다.
- SDK는 서버 전용입니다.
API_KEY와 가맹점 접근 토큰은 브라우저·앱 번들에 넣지 않습니다. - 결제 링크 API와 청구서 API를 같은 주문에 함께 호출하지 마세요. 청구서 API가 결제 링크도 만듭니다.
두 API의 차이
| 결제 링크 API(게이트웨이) | 청구서 API(청구 서버) | |
|---|---|---|
| 호출 결과 | 결제 페이지 링크(REDIRECT_URL) | 청구서 생성 + 알림톡/문자 발송 접수 |
| 고객 안내 | 귀사가 링크를 전달(리다이렉트·문자·이메일·QR) | 카리페이가 알림톡/문자로 발송 |
| 완료 확인 | CONFIRM_URL 콜백 + 조회 API | webhookUrl 웹훅 + 청구서 조회 API(상태 DONE) 또는 콘솔 |
| 취소 | 취소 API(전액) | 콘솔 또는 청구서 취소 API |
| 인증 | API_SIGN 서명 | 가맹점 접근 토큰(x-access-token) |
| 비용 | PG 수수료 | PG 수수료 + 발송 포인트 |
| 적합한 곳 | 웹·앱 결제, 원격 판매, 플랫폼 | 청구·수납 업무, 반복 청구, 개발 최소화 |
다음 단계
문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.