> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/api-guides-en/store-front/promotion/gift-event.md).

# Gift Event

Member-exclusive promotions are giveaway events the shopping mall offers to members, and only product gift events exist. This promotion is applied when the amount of the purchased product meets the gift event's minimum amount condition.

***

## Key Features

* **Gift event inquiry**
  * When entering the product detail page or order form, checks whether a selectable gift event exists, but only for members.
* **Application priority**
  * Even if a gift event applies to only one product, when there are multiple eligible products, the gift event is mapped to the product with the highest amount.
* **Stackable application**
  * If a single product has multiple applicable gift events, more than one can be selected simultaneously.
* **Gift event calculation and applicability determination**
  * Calculates the gift event based on the information selected by the user, and determines applicability by comparing the calculation result with the information selected by the user.
* **Event inquiry API calls**
  * On the product detail page and cart, the `/aeEvtList` API is called to retrieve selectable events.
  * On the order form, the `/chooseAeEvtList` API is called to retrieve selectable events.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FlPY2V5z3YIu823B2ntmg%2F183664826.jpg?alt=media&#x26;token=f316283b-dfbd-4e7b-a5fd-aba33fe5d701" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Product detail page

On the product detail page, retrieves the list of\
gift events applicable to the product.
{% endstep %}

{% step %}

### Cart

After entering the cart, the list of gift event products can be checked at the bottom.
{% endstep %}

{% step %}

### Order form

After entering the order form and clicking checkout, a gift event selection popup is displayed, and after selecting, checkout can proceed.
{% endstep %}

{% step %}

### Promotion gift event inquiry

⑤ Before calling the validation that checks whether a gift event is actually usable, checks whether common parameters exist.
{% endstep %}

{% step %}

### Applied gift event verification

This logic is a service-level validation and calculation logic; please refer to the 'process definition' in the feature overview \[Promotion Validation].
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="89.111083984375">API</th><th width="374.5555419921875">Description</th><th width="92.4444580078125">Server</th><th width="89.111083984375">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Order form gift event inquiry</td><td>Retrieves the list of gift events selectable in the current order. If the same gift event can apply to multiple products, it is applied to only one product. The criteria for selecting the product are as follows: * Sale price: descending order * Product number: ascending order * Item number: ascending order</td><td>Order</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC&#x26;path=getAeEvtList_1">🔗View API></a></td></tr><tr><td>Gift event applicability<br>check</td><td>Checks whether the gift event is actually usable.<br>Checks whether the amount after applying benefits to the purchased product meets the amount condition of the selected gift event</td><td>Order</td><td>POST</td><td><p><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC&#x26;path=getOrderAeEvtList">🔗View API></a></p><p>Gift product information inquiry: /API/goods/v1/detail/goods</p></td></tr><tr><td>Product detail gift event inquiry</td><td>Retrieves the list of usable gift events when entering product details.</td><td>Order</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=order&#x26;depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC&#x26;path=getAeEvtList_2">🔗View API></a></td></tr></tbody></table>

## Other Notes

* Gift event policy
  * Only product gift events exist as promotion gift events
  * Checks the amount hurdle based on the sale price per unit of the product
  * For product gift events, only products with combined-package shipping can be registered/used.
  * If the gift event's gift product is out of stock, it is not displayed.
  * Even if a single gift event can apply to multiple products, it is applied to the product with the highest sale price.

##