둘러보기

커머스 체크아웃 연동

상품 등록부터 취소·환불까지 쇼핑몰 기본 흐름으로 붙여요.

일반 쇼핑몰·B2C 커머스에서 상품을 올리고, 체크아웃으로 결제받고, 주문을 관리하고, 필요시 취소·환불 까지 처리하는 개발자 여정이에요.

이 문서는 누구에게 맞나

상품 카탈로그를 가진 일반 쇼핑몰을 만들고 Bootpay 커머스 SDK로 주문·체크아웃·결제 관리까지 한 번에 처리하려는 개발자용이에요.

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

기획 배경

결제만 붙일지, 커머스 SDK 까지 갈지의 판단은 결제만 vs 커머스 스코프 결정 를 먼저 봐요.

준비

  • application_id / private_key 발급 — 결제 SDK의 연동키 가 canonical. 커머스도 동일 키 사용.
  • 서버 SDK 설치 → 환경설정 (커머스 특화 설정)
  • PG 계약 완료 (주문·결제 연동 PG 확인)

단계 1: 상품 등록

기획 배경

상품 카테고리·옵션·재고 정책 설계는 Bootpay 블로그 commerce 카테고리 를 참고해요.

단계 2: 상품 진열 상태 관리

  • 할 일: 판매중/품절/숨김 등 전시 상태를 제어해요
  • API: 진열 상태
  • 동작: 상태 변경 즉시 목록 조회 결과에 반영

단계 3: 고객 가입·로그인

단계 4: 체크아웃 생성

이 API는 어느 흐름에 속하나

체크아웃 생성은 이 흐름의 단계 4. 결제 이전 "주문 생성 후 고객이 결제를 시작할 수 있는 상태" 를 만드는 API.

단계 5: 결제 완료 감지 (웹훅)

단계 6: 주문 조회·관리

단계 7: 취소·환불

커머스 취소는 4단 상태 전이​​예요. 단순 취소가 아니에요.

기획 배경

취소·환불 정책·승인 구조·회수 범위 설계는 주문 취소 정책 설계 를 봐요.

단계 8: (선택) 링크페이 생성

정기 청구·세금계산서가 필요하면 링크페이 여정으로 이어져요.

전체 플로우

상품 등록 → 고객 가입 → 체크아웃 → 결제 → 주문 관리 → 취소/환불 시퀀스 다이어그램은 주문 아키텍처 참고.

다음 단계

최신 글AI 연동 가이드 이전 글링크페이 연동