> 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-api/order-and-payment/payment.md).

# Payment

The step where users select a payment method and give final approval for the order. Users can review order details, enter delivery information, and proceed with the order. Users can also proceed with an order to gift a product to another member from the cart. Users can add selected products to the cart and manage them.

{% columns %}
{% column %}

<p align="center"><strong>PC</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FgsegOtO1kG7Z70EBfGDA%2Fimage-20240416-051025.png?alt=media&#x26;token=eec43f5e-e105-4951-b854-164dfc24c300" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<p align="center"><strong>Mobile</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FSqpubQ0usa4N4SzL7O6z%2Fimage-20240416-051036.png?alt=media&#x26;token=bb3929be-398d-4b8c-985a-9837edc98cb4" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Payment <a href="#plus" id="plus"></a>

<div align="center"><img src="https://tech.x2bee.com/download/attachments/266110671/Payment.drawio.png" alt=""></div>

### 1. Issue Order Number <a href="#id-1" id="id-1"></a>

When the payment button is clicked, this is called right before the merchant payment step to issue the order number.

* **Issue order number (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EC%84%9C/getNextOrdNo))\
  Issues the order number.

```
GET /v1/orderSheet/ordNo 
```

### 2. Look Up Gift Promotion <a href="#id-2" id="id-2"></a>

When the payment button is clicked, checks whether gift promotion information exists, and if related information exists, the gift promotion popup appears before payment.

* **Look up order form gift promotion (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EC%84%9C/getAeEvtList))\
  Looks up gift promotions using the order product information.

```
POST /v1/orderSheet/aeEvtList 
```

### 3. Look Up Merchant Information <a href="#id-3" id="id-3"></a>

When the payment button is clicked, if a PG payment amount is incurred, the related screen is called and displayed.

* **Look up merchant information (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EA%B2%B0%EC%A0%9C%EC%A0%95%EB%B3%B4/getPgMerchant))\
  If the linked payment merchant information differs, a different screen may be displayed.

```
POST /v1/payment/pgMerchant 
```

### 4. Place Order <a href="#id-4" id="id-4"></a>

When payment authentication succeeds, approves the payment and creates the order. If a non-member's order succeeds, non-member login processing is performed and a non-member cookie is created.

* **Place order (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EC%84%9C/order))\
  Creates the order.

```
POST /v1/order 
```

### 5. Look Up Order Completion Information <a href="#id-5" id="id-5"></a>

After the order succeeds, the completed order information is displayed. This API requires either member login or non-member login.

Clicking the View Order Details button at the bottom navigates to My Page > Order History Details.

* **Look up order completion information (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EC%84%9C/getOrderCompleteInfo))\
  Looks up the order completion information after the order succeeds.

```
POST /v1/order/getOrderCompleteInfo 
```

### 6. Look Up Customer Notification List <a href="#id-6" id="id-6"></a>

If relevant customer notification content exists, the customer notification list is looked up and displayed at the top of the order completion screen.

* **Look up screen customer notification (**[🔗View API >](https://api.x2bee.com/content?msa=common\&depth=%EA%B3%B5%ED%86%B5\&path=getContsList))\
  Looks up the customer notification history.

```
GET /v1/common/getContsList 
```

***

## Order Completion Screen by Order Type (Standard Order / Gifting Order / Non-Member Order) <a href="#plus" id="plus"></a>

<div align="center"><img src="https://tech.x2bee.com/download/attachments/266110671/1712117117349-Payment.drawio.png" alt=""></div>

{% hint style="info" %}
**The order completion screen differs slightly depending on the order type.**

* Gifting order: displays the gift card image and message selected at the time of order,\
  with only the recipient's name and mobile number shown in the recipient information.\
  Clicking View Order Details navigates to the sent gift box detail screen.
* Non-member order: the mileage to be accrued area does not exist.
  {% endhint %}