프로모션 사은행사

회원전용 프로모션은 쇼핑몰에서 회원을 대상으로 제공하는 증정 행사로, 상품 사은행사만 존재합니다. 이 프로모션은 구매한 상품의 금액이 사은행사의 최소금액 조건에 부합하면 적용됩니다.

주요 기능

사은행사 조회
- 상품상세나 주문서에 진입했을 때, 회원인 경우에만 선택 가능한 사은행사가 있는지 확인하고 조회합니다.
적용 우선순위
- 사은행사가 하나의 상품에만 적용되더라도, 여러 상품 중 금액이 가장 큰 상품에 사은행사가 매핑됩니다.
중복 적용 가능
- 하나의 상품에 여러 사은행사가 있는 경우 중복으로 선택이 가능합니다.
사은행사 계산 및 적용 여부 판단
- 사용자가 선택한 정보로 사은행사를 계산하고, 계산 결과와 사용자가 선택한 정보를 비교하여 적용 여부를 판단합니다.
행사 조회 API 호출
- 상품상세, 장바구니에서는 /aeEvtList API를 호출하여 선택 가능한 행사를 조회합니다.
- 주문서에서는 /chooseAeEvtList API를 호출하여 선택 가능한 행사를 조회합니다.

번호	업무	설명

번호	업무	설명
1	상품 상세페이지	상품상세 페이지에서 해당 상품에 적용 가능한 사은행사 목록을 조회 합니다.
2	장바구니	장바구니에 진입후 하단에 사은행사 상품의 목록확인 가능합니다.
3	주문서	주문서에 진입후 결제하기 클릭시 사은행사 선택팝업 노출이 되고, 선택하면 결제 진행이 가능합니다.
4	프로모션 사은행사 조회	⑤ 실제 사용 가능 사은행사 여부 확인 Validation 호출 전 공통 파라미터 여부 확인
5	적용 사은행사 여부 확인	해당 로직은 서비스 단위 검증 및 계산 로직으로, 기능개요 [프로모션 검증] 중 ’프로세스 정의’를 참고 해 주세요.

API	설명	Server	메소드	비고

API

설명

Server

메소드

비고

주문서 사은행사 조회

현재 주문에서 선택할 수 있는 사은행사 목록을 조회합니다. 여러 상품에 동일한 사은행사가 적용이 가능 하다면, 하나의 상품에만 적용 됩니다. 상품을 선택하는 기준은 아래와 같습니다. * 판매가 : 내림차순 * 상품번호 : 올림차순 * 단품번호 : 올림차순

Order

POST

사은행사 적용가능여부 확인

사은행사가 실제 사용 가능한 사은행사인지 확인합니다.
구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크

Order

POST

사은품 정보조회: /API/goods/v1/detail/goods

상품상세 사은행사 조회

상품 상세 진입 시 사용 가능한 사은행사 리스트를 조회합니다.

Order

POST