버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

사용자가 주문을 생성하고 결제를 완료하는 주문서 관리 기능을 제공합니다. 주문서는 다양한 상황과 조건에 따라 구분되며, 사용자의 요청 정보 및 상품, 배송, 결제 등 다양한 정보를 검증하고 조회하여 원활한 주문 프로세스를 지원합니다.

...

주요 기능

  • 주문서 진입 및 검증

    • 주문서는 상품 상세페이지나 장바구니 화면에서 진입이 가능하며, 15세 이상의 회원 또는 인증을 통과한 비회원만 주문서에 접근할 수 있습니다.

  • 다양한 주문서 유형

    • 주문 기준으로는 일반 주문과 선물하기 주문서가 있으며, 회원 정보 기준으로는 회원 주문과 비회원 주문서로 구분됩니다.

  • 주문 정보 조회 및 검증

    • 최초 주문서 진입 시 주문자 나이, 선물하기 주문 시 회원 여부, 비회원 주문 시 인증 여부 등을 검증합니다.

  • 혜택 및 결제 정보 조회

    • 주문 상품 별 사용 가능한 결제수단 중 중복된 수단을 분류하고 해당 결제수단에 필요한 정보를 조회하여 노출합니다.

  • 배송비 및 배송 그룹 관리

    • 상품 별 배송정보에 따라 배송그룹을 나누어 배송비를 조회하며, 배송지의 도서산간 여부에 따라 추가 배송비가 부과될 수 있습니다.

  • 사은행사 및 혜택 조회

    • 회원 주문서일 경우 사은행사가 존재할 때 결제 전 사은행사 팝업을 노출하고, 쿠폰 및 혜택 팝업에서 사용 가능한 혜택정보와 최대혜택정보를 조회합니다.

  • 주문 생성 및 완료

    • 주문 생성에 필요한 필수 값들을 검증하고 주문번호를 채번한 후, 결제에 필요한 인증 작업이 끝나면 주문 생성 API를 호출하여 주문을 완료합니다.

    • 주문에 성공하면 주문완료 페이지에서 주문완료정보 조회 API를 호출하여 주문정보를 사용자에게 노출합니다.

프로세스 정의

...

구분

설명

1

주문서 검증

사용자는 상품 상세, 장바구니 화면에서 주문서에 진입할 수 있습니다.

주문서 진입 시 Request 정보, 주문자 나이,

선물하기 주문 시 사용자의 회원 여부,

비회원 주문 시 인증 여부를 검증합니다.

2

주문서 조회

회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보를 주문서 노출에 필요한 주문서 정보와 주문생성을 위한 주문생성 정보로 구분하여 전달합니다.

3

주문서 사은행사 조회

주문한 상품의 사은행사 정보를 조회하여,

사은행사가 존재할 경우 결제 전 사은행사 팝업을 노출합니다.

4

배송비 조회

화면에서 주문배송지가 변경될 때마다 배송비를 재조회합니다.

5

혜택정보 조회

혜택 팝업에서 노출하기 위한 사용 가능한 혜택 정보를 조회합니다.
(프로모션 문서 참조)

6

적립정보 조회

화면에서 혜택이 변경될 때마다 적립정보를 재조회합니다.

7

주문번호 채번

주문 생성을 위한 주문번호를 채번합니다.

8

결제정보 조회

결제 인증에 필요한 PG 정보, 가맹점 정보 등을 조회합니다. (결제 문서 참조)

9

주문하기

화면에서 선택한 주문정보를 바탕으로 주문생성을 합니다. 주문생성 성공 시 주문자에게 알림톡과 메일을 발송합니다.

10

주문 완료정보 조회

주문완료 페이지를 노출하기 위한 주문완료정보를 조회합니다.

API 기능 목록

API

설명

Server

메소드

비고

주문서 진입 검증

주문서 진입 시 사용자 검증을 진행합니다.

Order

POST

🔗API 확인하기>

주문서 조회

주문서 정보를 조회합니다.

주문서 정보에는 회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보들이 포함됩니다.

Order

POST

🔗API 확인하기>

1)회원 정보 조회
/api/member/v1/front/memberInfo

2)비회원 정보 조회
/api/member/v1/front/nonMemberInfo

3)회원 기본배송지 조회
/api/member/v1/front/dlvpInfo

4)상품별 사용가능 결제수단 조회
/api/goods/v1/detail/goodsPayMeanList

주문서 사은행사 조회

주문 상품 정보를 이용하여 사은행사를 조회합니다.

사은 행사가 존재할 경우, 결제하기 이전에 해당 사은 행사 정보를 포함하는 팝업을 노출합니다.

Order

POST

🔗API 확인하기>

주문서 배송비 조회

주문 정보에 대한 배송비를 조회합니다.

Order

POST

🔗API 확인하기>

주문서 적립정보 조회

주문 정보에 대한 적립 정보를 조회합니다.

Order

POST

🔗API 확인하기>

주문번호 채번

주문 생성 정보에 필요한 주문번호를 채번합니다.

Order

GET

🔗API 확인하기>

주문하기

주문을 생성합니다.

주문에 성공하면 주문자에게 알림톡과 메일을 발송합니다.

Order

POST

 🔗API 확인하기>

1)회원 정보 조회
/api/member/v1/front/memberInfo

2)임직원할인한도 업데이트
/api/member/v1/staff/dcLimIncDec

3)상품 재고 업데이트
/api/goods/v1/order/stockUpdate

주문완료정보 조회

주문 성공 후 주문완료 정보를 조회합니다.

조회 요청한 주문에 클레임이 진행되었다면 예외가 발생합니다.

Order

POST

🔗API 확인하기>

용어 정의

명칭

설명

비고

배송그룹

상품의 상품번호, 합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 배송예약일시, 출고예정일시 등 정보를 기준으로 함께 배송이 가능한 상품의 집합입니다.

이 집합 별로 배송비를 계산합니다.

합배송

주문서 내의 여러 개의 상품을 배송그룹 별로 배송하는 방식

기타 참고사항

  • 배송비를 조회하기 전 상품 별 상세 정보를 이용하여 배송 그룹을 생성합니다.
    (합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 상품번호, 배송예약일시, 출고예정일시)

  • 주문완료정보 조회 API 요청 시 비회원 주문의 경우 비회원 로그인 처리 API를 통해 생성된 쿠키 값을 필수로 전달해야 합니다.