둘러보기

상품 카탈로그 연동

카탈로그 구조를 먼저 고정해 이후 주문 흐름 흔들림을 막아요.

상품 구조를 먼저 고정해 이후 체크아웃과 주문 흐름이 흔들리지 않게 만드는 여정이에요.

이 문서는 누구에게 맞나

카탈로그를 서비스의 중심 데이터로 쓰고 싶고, 상품 생성·진열 상태·옵션·재고를 한 체계 안에서 운영하려는 개발자용이에요. 프론트보다 먼저 상품 구조를 안정화해야 하는 팀에 맞아요.

다음이면 다른 문서로 가요.

기획 배경

카탈로그는 결제 직전 화면이 아니라 상품 정책을 고정하는 레이어예요. SKU, 옵션, 진열 상태를 먼저 정해야 이후 주문과 재고가 안정돼요.

준비

  • application_id / private_key — 결제 SDK의 연동키 가 canonical
  • 서버 SDK 설치 → 환경설정
  • SKU 규칙, 카테고리 체계, 옵션 naming 규칙, 품절 정책 확정

단계 1: 카테고리와 식별 규칙을 설계해요

단계 2: 상품을 등록해요

  • 할 일: 판매할 상품 기본 정보를 서버에서 생성하고 내부 상품 ID와 매핑해요.
  • API:
  • 필수 값: name, price, quantity

단계 3: 옵션·재고를 관리해요

  • 할 일: 사이즈, 색상, 구독 기간 같은 옵션과 재고 수량을 수정 흐름에 붙여요.
  • API:
  • 필수 값: options, quantity

단계 4: 진열 제어를 붙여요

단계 5: 상품 검색·조회 흐름을 검증해요

  • 할 일: 목록 조회 기준과 상세 진입 기준이 프론트 상품 화면과 일치하는지 검증해요.
  • API:
  • 필수 값: product_id, keyword

완료 후 체크

  • 상품명, 가격, 재고, SKU 가 서버 기준으로 고정되어 있어요.
  • 품절과 숨김 상태가 운영 규칙대로 분리되어 있어요.
  • 옵션 변경 뒤 목록 조회와 실제 결제 가능 수량이 어긋나지 않아요.
  • 체크아웃 입력에 필요한 product_id 와 가격 기준이 안정적으로 나와요.

관련 문서

최신 글주문 관리 연동 이전 글고객·그룹 연동