주문 상태 흐름

주문의 전체 상태 흐름, 웹훅 이벤트 매핑, 취소 규칙, Sandbox 동작 차이를 안내합니다.

상태 흐름도

주문은 다음과 같은 순서로 상태가 전이됩니다.

PAID (20)

→

PDF_READY (25)

→

CONFIRMED (30)

→

IN_PRODUCTION (40)

→

PRODUCTION_COMPLETE (50)

→

SHIPPED (60)

→

DELIVERED (70)

파트너 취소:

PAID / PDF_READY

→

CANCELLED_REFUND (81)

관리자 취소:

SHIPPED 이전 상태

→

CANCELLED (80) / CANCELLED_REFUND (81)

각 주문 상태 전이 시 발송되는 웹훅 이벤트와 주요 필드입니다.

상태	코드	Webhook Event	주요 필드
`PAID`	`20`	`order.created`	`total_amount`, `item_count`
`CONFIRMED`	`30`	`production.confirmed`	`print_day`
`IN_PRODUCTION`	`40`	`production.started`	`print_day`
`PRODUCTION_COMPLETE`	`50`	`production.completed`	`completed_at`
`SHIPPED`	`60`	`shipping.departed`	`tracking_number`, `tracking_carrier`
`CANCELLED` / `CANCELLED_REFUND`	`80` / `81`	`order.cancelled`	`cancel_reason`, `refund_amount`

Sandbox 환경에서는 주문이 PAID 상태에서 멈춥니다. 실제 제작이나 배송이 진행되지 않으며, 상태 전이 테스트는 웹훅 테스트 기능을 활용하세요.

Sandbox에서는 PAID 이후 자동 상태 전이가 발생하지 않습니다. 웹훅 수신 테스트는 POST /webhooks/test를 활용하세요.

파트너가 API로 직접 취소할 수 있는 상태는 PAID(20)와 PDF_READY(25)뿐입니다. 이후 상태에서는 관리자만 취소할 수 있습니다.

취소 주체	취소 가능 상태	결과 상태	충전금 환불
파트너 (API)	`PAID` (20), `PDF_READY` (25)	`CANCELLED_REFUND` (81)	즉시 환불
관리자	`SHIPPED` (60) 이전까지	`CANCELLED` (80) / `CANCELLED_REFUND` (81)	관리자 판단에 따름

단계	소요 기간	비고
제작 (CONFIRMED → PRODUCTION_COMPLETE)	3~4 영업일	공휴일 제외
배송 (SHIPPED → DELIVERED)	1~2일	한진택배