주문서
사용자가 주문을 생성하고 결제를 완료하는 주문서 관리 기능을 제공합니다. 주문서는 다양한 상황과 조건에 따라 구분되며, 사용자의 요청 정보 및 상품, 배송, 결제 등 다양한 정보를 검증하고 조회하여 원활한 주문 프로세스를 지원합니다.
주요 기능
주문서 진입 및 검증
주문서는 상품 상세페이지나 장바구니 화면에서 진입이 가능하며, 15세 이상의 회원 또는 인증을 통과한 비회원만 주문서에 접근할 수 있습니다.
다양한 주문서 유형
주문 기준으로는 일반 주문과 선물하기 주문서가 있으며, 회원 정보 기준으로는 회원 주문과 비회원 주문서로 구분됩니다.
주문 정보 조회 및 검증
최초 주문서 진입 시 주문자 나이, 선물하기 주문 시 회원 여부, 비회원 주문 시 인증 여부 등을 검증합니다.
혜택 및 결제 정보 조회
주문 상품 별 사용 가능한 결제수단 중 중복된 수단을 분류하고 해당 결제수단에 필요한 정보를 조회하여 노출합니다.
배송비 및 배송 그룹 관리
상품 별 배송정보에 따라 배송그룹을 나누어 배송비를 조회하며, 배송지의 도서산간 여부에 따라 추가 배송비가 부과될 수 있습니다.
사은행사 및 혜택 조회
회원 주문서일 경우 사은행사가 존재할 때 결제 전 사은행사 팝업을 노출하고, 쿠폰 및 혜택 팝업에서 사용 가능한 혜택정보와 최대혜택정보를 조회합니다.
주문 생성 및 완료
주문 생성에 필요한 필수 값들을 검증하고 주문번호를 채번한 후, 결제에 필요한 인증 작업이 끝나면 주문 생성 API를 호출하여 주문을 완료합니다.
주문에 성공하면 주문완료 페이지에서 주문완료정보 조회 API를 호출하여 주문정보를 사용자에게 노출합니다.
프로세스 정의
구분 | 설명 | |
---|---|---|
1 | 주문서 검증 | 사용자는 상품 상세, 장바구니 화면에서 주문서에 진입할 수 있습니다. 주문서 진입 시 Request 정보, 주문자 나이, 선물하기 주문 시 사용자의 회원 여부, 비회원 주문 시 인증 여부를 검증합니다. |
2 | 주문서 조회 | 회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보를 주문서 노출에 필요한 주문서 정보와 주문생성을 위한 주문생성 정보로 구분하여 전달합니다. |
3 | 주문서 사은행사 조회 | 주문한 상품의 사은행사 정보를 조회하여, 사은행사가 존재할 경우 결제 전 사은행사 팝업을 노출합니다. |
4 | 배송비 조회 | 화면에서 주문배송지가 변경될 때마다 배송비를 재조회합니다. |
5 | 혜택정보 조회 | 혜택 팝업에서 노출하기 위한 사용 가능한 혜택 정보를 조회합니다. |
6 | 적립정보 조회 | 화면에서 혜택이 변경될 때마다 적립정보를 재조회합니다. |
7 | 주문번호 채번 | 주문 생성을 위한 주문번호를 채번합니다. |
8 | 결제정보 조회 | 결제 인증에 필요한 PG 정보, 가맹점 정보 등을 조회합니다. (결제 문서 참조) |
9 | 주문하기 | 화면에서 선택한 주문정보를 바탕으로 주문생성을 합니다. 주문생성 성공 시 주문자에게 알림톡과 메일을 발송합니다. |
10 | 주문 완료정보 조회 | 주문완료 페이지를 노출하기 위한 주문완료정보를 조회합니다. |
API 기능 목록
API | 설명 | Server | 메소드 | 비고 |
---|---|---|---|---|
주문서 진입 검증 | 주문서 진입 시 사용자 검증을 진행합니다. | Order | POST | |
주문서 조회 | 주문서 정보를 조회합니다. 주문서 정보에는 회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보들이 포함됩니다. | Order | POST | 1)회원 정보 조회 2)비회원 정보 조회 3)회원 기본배송지 조회 4)상품별 사용가능 결제수단 조회 |
주문서 사은행사 조회 | 주문 상품 정보를 이용하여 사은행사를 조회합니다. 사은 행사가 존재할 경우, 결제하기 이전에 해당 사은 행사 정보를 포함하는 팝업을 노출합니다. | Order | POST | |
주문서 배송비 조회 | 주문 정보에 대한 배송비를 조회합니다. | Order | POST | |
주문서 적립정보 조회 | 주문 정보에 대한 적립 정보를 조회합니다. | Order | POST | |
주문번호 채번 | 주문 생성 정보에 필요한 주문번호를 채번합니다. | Order | GET | |
주문하기 | 주문을 생성합니다. 주문에 성공하면 주문자에게 알림톡과 메일을 발송합니다. | Order | POST | 1)회원 정보 조회 2)임직원할인한도 업데이트 3)상품 재고 업데이트 |
주문완료정보 조회 | 주문 성공 후 주문완료 정보를 조회합니다. 조회 요청한 주문에 클레임이 진행되었다면 예외가 발생합니다. | Order | POST |
용어 정의
명칭 | 설명 | 비고 |
---|---|---|
배송그룹 | 상품의 상품번호, 합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 배송예약일시, 출고예정일시 등 정보를 기준으로 함께 배송이 가능한 상품의 집합입니다. 이 집합 별로 배송비를 계산합니다. |
|
합배송 | 주문서 내의 여러 개의 상품을 배송그룹 별로 배송하는 방식 |
|
기타 참고사항
배송비를 조회하기 전 상품 별 상세 정보를 이용하여 배송 그룹을 생성합니다.
(합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 상품번호, 배송예약일시, 출고예정일시)주문완료정보 조회 API 요청 시 비회원 주문의 경우 비회원 로그인 처리 API를 통해 생성된 쿠키 값을 필수로 전달해야 합니다.