Bootpay Commerce는 쇼핑몰을 쉽게 만들기 위한 커머스 백엔드예요. 결제창만 띄우는 데서 끝나지 않고, 상품·고객·주문·체크아웃·구독·링크페이·마켓플레이스 흐름을 같은 기준으로 연결해요.
결제 SDK가 “결제를 성공시키는 일”에 집중한다면, 커머스 SDK는 결제 전후의 쇼핑몰 운영을 줄이는 일에 집중해요.
한 줄 판단
- 자체 주문·상품·고객 시스템이 이미 있으면 결제 매뉴얼이 더 빨라요.
- 쇼핑몰 백엔드를 새로 만들거나 줄이고 싶으면 커머스 매뉴얼에서 시작해요.
- 구독·링크페이·B2B 그룹처럼 결제 이후 운영이 길면 커머스 SDK가 더 잘 맞아요.
왜 커머스가 필요할까
쇼핑몰은 화면만 보면 단순해 보여요. 하지만 운영을 시작하면 작은 ERP처럼 복잡해져요.
| 처음 생각 | 실제로 챙겨야 하는 것 |
|---|---|
| 상품 하나 등록하면 돼요 | 옵션, 가격, 판매 상태, 노출 여부를 계속 맞춰야 해요 |
| 결제 성공하면 주문 완료예요 | 서버에서 금액·상태를 다시 검증하고 주문을 확정해야 해요 |
| 회원 정보만 저장하면 돼요 | 비회원, 그룹, 로그인 토큰, 구독 고객을 구분해야 해요 |
| 취소 버튼 하나면 돼요 | 취소 요청, 승인·거절, 환불, 서비스 비활성화 기준이 필요해요 |
| 구독은 매달 결제하면 돼요 | 신청, 승인, 회차, 일시정지, 재개, 해지를 상태로 관리해야 해요 |
Bootpay Commerce는 이 기준을 처음부터 다 직접 설계하지 않도록 도와줘요. 상품을 등록하고, 고객을 식별하고, 체크아웃으로 주문을 열고, 결제 결과를 주문 상태로 이어가면 돼요.
결제 API와 커머스 API 차이
| 구분 | 결제 API | 커머스 API |
|---|---|---|
| 중심 | 결제창 호출·승인·취소 | 상품·고객·주문 라이프사이클 |
| 주문 DB | 서비스가 직접 구현 | Bootpay 주문 객체와 API를 사용 |
| 상품 정보 | 결제 요청마다 직접 전달 | 카탈로그에 등록하고 재사용 |
| 고객 정보 | 결제 요청 데이터로 전달 | 고객 API·로그인 토큰으로 연결 |
| 적합한 경우 | 기존 주문 시스템이 이미 있음 | 쇼핑몰 백엔드를 새로 만들거나 줄이고 싶음 |
커머스 SDK가 줄여주는 일
| 직접 만들면 복잡해지는 일 | 커머스 SDK가 잡아주는 기준 |
|---|---|
| 장바구니를 주문서로 바꾸는 규칙 | 체크아웃 요청과 주문 객체 |
| 상품 ID, 옵션, 가격을 매 요청마다 맞추는 일 | 카탈로그에 등록한 상품 기준 재사용 |
| 결제 성공 콜백과 서버 주문 상태를 맞추는 일 | 주문 조회 API와 웹훅으로 재검증 |
| 회원·비회원·구독 고객을 따로 관리하는 일 | 고객 API와 로그인 토큰 기준 연결 |
| 취소·환불·구독 해지 흐름을 기능마다 다시 짜는 일 | 주문·구독 상태 변경 이벤트 기준 처리 |
다음 단계
| 하고 싶은 일 | 다음 문서 |
|---|---|
| 어떤 기능부터 볼지 고르고 싶어요 | 커머스 상품 둘러보기 |
| 키 발급과 SDK 설치가 필요해요 | 환경 설정 |
| 첫 쇼핑몰 흐름을 빠르게 붙여요 | 체크아웃 빠른 매뉴얼 |
| AI 코딩 도구에 맡기고 싶어요 | AI 연동 가이드 |