"상품은 올렸는데 판매 상태와 재고를 어디서 제어해야 할지 애매해요." — 상품 카탈로그를 커머스 SDK로 붙이는 실전 가이드예요.
핵심 요약
- 누구 것인가: 자체 상품 DB를 새로 만들기보다 Bootpay 카탈로그 중심으로 진열과 판매 상태를 정리하려는 팀용이에요.
- 무엇을 다루나: 상품 생성, 판매 상태 관리, 옵션·재고 업데이트, 목록 조회 흐름을 다뤄요.
- 완성 후 모습: 상품 등록부터 진열 제어까지 한 API 집합으로 운영할 수 있어요.
이런 상황이라면
상품명과 가격만 저장해 두고 나중에 옵션이나 재고를 붙이려 하면 데이터 모델이 금방 흔들려요. 특히 품절, 숨김, 재입고 예정 같은 상태를 프론트 규칙으로만 처리하면 운영팀과 개발팀의 기준이 달라져요. 카탈로그는 결제 직전 화면보다 앞단에서 구조를 고정하는 문서라고 생각하는 편이 맞아요.
완성 후 모습
- 카테고리 정의 → 상품 생성 → 옵션·재고 수정 → 판매 상태 반영 → 목록 조회와 상세 노출 기준 확정
구현 순서
1상품 기본 정보를 만들어요
- 할 일: 상품명, 가격, SKU, 카테고리, 재고 기준값을 서버에서 생성해요.
- API: 상품 생성
2진열 상태를 제어해요
- 할 일: 판매중, 품절, 숨김 같은 노출 상태를 운영 화면에서 즉시 바꿀 수 있게 만들어요.
- API: 진열 상태 관리
- 주의: 품절과 숨김을 같은 상태로 두면 CS와 광고 운영 데이터가 섞이기 쉬워요.
3옵션과 재고를 업데이트해요
- 할 일: 옵션 구조와 수량 변경을 상품 수정 요청에 반영해요.
- API: 상품 수정