개발자센터시작하기
개발자 센터 소개
빌링플러스 공개 API·웹훅·등록창으로 카드 정기결제를 가맹점 시스템에 연동하는 방법을 안내합니다.
빌링플러스는 카드 정기결제·수시결제·청구서결제를 처리하는 서비스입니다. 가맹점 담당자가 화면에서 하는 일 가운데 상당 부분을 가맹점 시스템에서도 할 수 있도록 공개 API · 등록창 · 가입 링크 · 웹훅을 제공합니다.
화면만으로 먼저 운영하고, 필요한 업무부터 연결하세요.
연동은 필수가 아닙니다. 회원 등록, 카드 등록, 매달 자동결제, 미납 관리는 빌링플러스 화면만으로 모두 할 수 있습니다. "결제가 되면 우리 서비스의 이용권을 늘린다" 처럼 꼭 자동으로 이어져야 하는 일부터 하나씩 연결하면 됩니다.
무엇을 연동할 수 있나요
카드번호는 받지 않습니다
공개 API 에는 카드번호를 보내는 엔드포인트가 없습니다. 의도된 설계입니다. 카드번호가 가맹점 서버와 API 를 오가지 않아야 가맹점이 카드 정보 보안 책임을 떠안지 않습니다.
회원의 카드는 다음 세 가지 방법으로만 등록합니다.
- 등록창 — 가맹점 사이트에서 띄우는 팝업에 회원이 직접 입력합니다.
- 가입 링크 — 홈페이지 버튼으로 들어온 회원이 가입하면서 입력합니다.
- 빌링플러스 화면 — 담당자가 대신 등록하거나 등록 링크를 보냅니다.
API 는 등록이 끝난 결제수단(카드)의 번호(payment_method_id)와 마스킹된 카드번호만 다룹니다.
기준 주소와 공통 규칙
기준 주소
https://api.billingplus.co.kr/api/v1| 항목 | 규칙 |
|---|---|
| 형식 | 요청·응답 모두 UTF-8 JSON |
| 인증 | API 키 + HMAC-SHA256 요청 서명 — 인증 · 요청 서명 |
| POST | Idempotency-Key 헤더 필수 — 멱등키 |
| 금액 | 원 단위 정수(문자열이 아닌 숫자) |
| 시간 | ISO-8601 + 한국 시각 오프셋(2026-10-28T14:00:00+09:00), 날짜는 YYYY-MM-DD |
| 목록 | 커서 페이지네이션(기본 20건, 최대 100건) — 목록 · 레이트리밋 |
| 에러 | {"error": {"code", "message", "detail", "request_id"}} — 에러 응답 |
| 버전 | v1 안에서는 필드 추가만 합니다 — 변경 이력 |
연동 순서
- 빌링플러스에 가입하고 결제사 연결을 마칩니다. 결제(승인)는 결제사 연결이 끝난 뒤에 실행됩니다.
- 가맹점 마스터 계정으로 빌링플러스 화면의 연동관리 > API 연동에서 API 키를 발급합니다.
GET /api/v1/ping으로 서명이 맞는지 확인합니다 — 빠른 시작- 필요한 업무 하나를 고릅니다. 카드 등록이면 등록창, 홈페이지 가입이면 가입 링크, 결제 결과 반영이면 웹훅부터 시작합니다.
- 연동관리 > 웹훅 설정에서 수신 주소를 등록하고 [테스트 발송]으로 받는 쪽을 확인합니다.
테스트 전용 키나 별도의 테스트 서버는 현재 제공하지 않습니다. 발급한 키는 실제 가맹점 데이터에 연결됩니다. 결제를 일으키지 않고 서명·멱등키 설정을 맞출 때는 GET /api/v1/ping · POST /api/v1/ping 을 쓰세요.
다음 읽을 문서
- 빠른 시작 — 키 발급부터 첫 요청까지
- 인증 · 요청 서명 — 언어별 서명 예제
- AI 코딩 도구로 연동하기 — 규격을 AI 도구에 정확히 전달하는 설명문
- 웹훅 받기 — 결제 결과를 받는 방법
- API 레퍼런스 — 전체 엔드포인트와 스펙 문서