사은행사

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

---

주요 기능

• 사은행사 조회

  • 상품상세나 주문서에 진입했을 때, 회원인 경우에만 선택 가능한 사은행사가 있는지 확인하고 조회합니다.

• 적용 우선순위

  • 사은행사가 하나의 상품에만 적용되더라도, 여러 상품 중 금액이 가장 큰 상품에 사은행사가 매핑됩니다.

• 중복 적용 가능

  • 하나의 상품에 여러 사은행사가 있는 경우 중복으로 선택이 가능합니다.

• 사은행사 계산 및 적용 여부 판단

  • 사용자가 선택한 정보로 사은행사를 계산하고, 계산 결과와 사용자가 선택한 정보를 비교하여 적용 여부를 판단합니다.

• 행사 조회 API 호출

  • 상품상세, 장바구니에서는 /aeEvtList API를 호출하여 선택 가능한 행사를 조회합니다.

  • 주문서에서는 /chooseAeEvtList API를 호출하여 선택 가능한 행사를 조회합니다.

프로세스 정의

1

상품 상세페이지

상품상세 페이지에서 해당 상품에 적용 가능한 사은행사 목록을 조회 합니다.

2

장바구니

장바구니에 진입후 하단에 사은행사 상품의 목록확인 가능합니다.

3

주문서

주문서에 진입후 결제하기 클릭시 사은행사 선택팝업 노출이 되고, 선택하면 결제 진행이 가능합니다.

4

프로모션 사은행사 조회

⑤ 실제 사용 가능 사은행사 여부 확인 Validation 호출 전 공통 파라미터 여부 확인

5

적용 사은행사 여부 확인

해당 로직은 서비스 단위 검증 및 계산 로직으로, 기능개요 [프로모션 검증] 중 ’프로세스 정의’를 참고 해 주세요.

API 기능 목록

API	설명	Server	메소드	비
주문서 사은행사 조회	현재 주문에서 선택할 수 있는 사은행사 목록을 조회합니다. 여러 상품에 동일한 사은행사가 적용이 가능 하다면, 하나의 상품에만 적용 됩니다. 상품을 선택하는 기준은 아래와 같습니다. * 판매가 : 내림차순 * 상품번호 : 올림차순 * 단품번호 : 올림차순	Order	POST	🔗API 확인하기>
사은행사 적용가능여부 확인	사은행사가 실제 사용 가능한 사은행사인지 확인합니다. 구매한 상품에 혜택을 적용한 금액이 선택한 사은행사의 금액 조건에 부합하는지 체크	Order	POST	🔗API 확인하기> 사은품 정보조회: /API/goods/v1/detail/goods
상품상세 사은행사 조회	상품 상세 진입 시 사용 가능한 사은행사 리스트를 조회합니다.	Order	POST	🔗API 확인하기>

기타 참고사항

• 사은행사 정책

  • 프로모션 사은행사는 상품 사은행사만 존재

  • 상품 개당 판매가를 기준으로 금액 허들을 체크합니다

  • 상품 사은행사의 경우 합포장 배송인 상품만 등록/사용이 가능합니다.

  • 사은행사의 사은품이 재고가 부족한 경우에는 미노출이 됩니다.

  • 하나의 사은행가사 여러 개의 상품에 적용이 가능해도 판매가가 가장 큰 상품에 적용합니다.