주문·배송

주문 관리 붙이기

취소 요청과 승인을 한 상태로 뭉개면 고객 응대와 정산이 꼬여요.

구현에 필요한 엔드포인트·인증·오류 전체는 주문 API와 주문 처리 API를 확인해요.

"결제는 되었는데 주문 상태를 어디서 어떻게 바꿔야 할지 모르겠어요." — 주문 관리를 커머스 SDK로 붙이는 실전 가이드예요.

그래서 이 문서는 관리자 주문 화면, 고객 주문 내역, 취소·환불 운영을 한 세트로 붙여요. 체크아웃 완료 → 주문 생성 → 목록 조회 → 상세 확인 → 발송처리·배송 추적 → 취소 요청·승인 → 웹훅 기준 상태 동기화 순으로 이어붙이면, 결제 직후 생긴 주문이 조회·운영·환불 루프까지 끊기지 않고 흘러가요.

구현 순서

1주문 목록과 기준 상태를 정의해요

  • 할 일​: pending, paid, cancel_requested, cancelled 같은 상태 이름을 서비스 DB와 맞춰요.
  • API: 주문 목록, 주문 개요

2주문 상세 조회를 붙여요

  • 할 일​: 고객 주문 내역과 관리자 상세 화면을 order_number 기준으로 조회 가능하게 만들어요.
  • API: 주문 상세
  • 주의​: 프론트에서 보여 주는 금액과 서버에서 검증한 금액 기준이 다르면 클레임이 바로 생겨요.

3실물 배송이면 발송처리를 붙여요

  • 할 일​: 창고·WMS 에서 운송장이 나오면 발주 단위로 택배사·운송장을 올려요. 그 뒤 배송 단계는 자동으로 쌓이니 따로 폴링하지 않아요.
  • API: 발송처리, 배송추적 조회
  • 주의​: 배송은 주문이 아니라 발주(order_purchases) 단위​​예요. 한 주문이 나눠 나가면 운송장도 나뉘어요.

4상태 변경과 취소 루프를 분리해요

  • 할 일​: 고객 취소 요청과 관리자 승인·거절 단계를 서로 다른 액션으로 둬요.
  • API: 취소 요청, 취소 승인, 취소 거절, 취소 철회
  • 주의​: 이미 발송된 주문은 결제 취소만으로 끝나지 않아요. 발주 상태를 먼저 확인해요.

5웹훅으로 상태를 다시 맞춰요

다음 단계

최신 글주문 개요 이전 글주문 조회