주문 관리 붙이기

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

핵심 요약

• 누구 것인가​: 관리자 주문 화면, 고객 주문 내역, 취소·환불 운영까지 한 세트로 다루려는 팀용이에요.
• 무엇을 다루나​: 주문 목록, 주문 상세, 상태 전이, 취소·환불, 웹훅 동기화를 다뤄요.
• 완성 후 모습​: 결제 완료 직후 생성된 주문이 조회·운영·환불 루프로 자연스럽게 이어져요.

이런 상황이라면

결제 성공 이벤트는 받았는데 주문 목록 화면이 비어 있거나 상태가 뒤늦게 바뀌는 경우가 많아요. 특히 취소 요청과 관리자 승인 단계를 한 상태로 뭉개면 고객 응대와 정산이 바로 꼬여요. 주문은 결제 성공 한 번으로 끝나는 데이터가 아니라 이후 운영을 계속 품는 엔티티라고 봐야 해요.

완성 후 모습

• 체크아웃 완료 → 주문 생성 → 주문 목록 조회 → 상세 확인 → 취소 요청·승인 → 웹훅 기준 상태 동기화

구현 순서

다음 단계

• 연동 경로​: 주문 관리
• 참고​: 주문 흐름 아키텍처