# 구매 API - 구매 확정 요청

## 1. API Overview

### Purpose

[context]
구매 확정을 요청하는 API입니다.<br>주문번호와 상품 순번(seq)을 기반으로 구매를 확정합니다.<br>이 API는 상점에서 배송 완료 후 구매를 확정하는 데 사용됩니다.<br>요청은 하나 이상의 상품에 대해 가능하며, 성공 시 각 상품별 처리 결과를 반환합니다.
[/context]

### Details

[table:key-value]
| 항목            | 값                      |
| :-------------- | :---------------------- |
| **API Name**    | 구매 확정 요청          |
| **API Path**    | /api/v2/payment/confirm |
| **API ID**      | EBP_API_214             |
| **HTTP Method** | [badge:POST,blue,lg]    |
| **Region** | [badge:Global,green-subtle,lg] |
[/table]

## 2. Request Specification

### 2.1 Request Header

@@include:common-headers-link.md@@

### 2.2 Request Data Schema

| depth | Field   | Details & Description                         |
|:------| :------ |:----------------------------------------------|
| 0     | orderNo | [type:string] [req:Yes] [desc:주문번호]           |
| 0     | items   | [type:array] [req:Yes] [desc:구매 확정 요청 대상 아이템] |
| 1     | itemSeq | [type:string] [req:Yes] [desc:일련번호]           |

### 2.3 Request Examples

#### JSON Example

```json
{
  "orderNo": "1768806886289",
  "items": [
    {
      "itemSeq": 1
    },
    {
      "itemSeq": 2
    }
  ]
}
```

## 3. Response Specification

### 3.1 Response Data Schema

@@include:standard-response.md@@
| -1    | data       | [type:object] [req:Yes] [desc:응답 데이터]                                                                                      |
| 0     | orderNo    | [type:string] [req:Yes] [desc:주문번호]                                                                                        |
| 0     | items      | [type:array] [req:Yes] [desc:-]                                                                                            |
| 1     | itemSeq    | [type:string] [req:Yes] [desc:일련번호]                                                                                        |
| 1     | resultCode | [type:string] [req:Yes] [desc:결과코드] [eg:000:성공]]                                                                           |
| 1     | message    | [type:string] [req:Yes] [desc:메세지] |

### 3.2 Response Samples

[tabs]
[tab:Success]

```json
{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "1767141311746",
  "timestamp": "2025-12-31T00:35:11.748775Z",
  "data": {
    "orderNo": "1768806886289",
    "items": [
      {
        "itemSeq": "1",
        "resultCode": "000",
        "message": "SUCCESS"
      },
      {
        "itemSeq": "2",
        "resultCode": "000",
        "message": "SUCCESS"
      }
    ]
  }
}
```

[tab:Failure(Already Canceled)]

```json
{
  "resultCode": "EBP-Z-0006",
  "message": "It has already been canceled: 7202512167722065",
  "requestId": "1768804833068",
  "timestamp": "2026-01-19T06:40:33.069217100Z",
  "data": {
    "orderNo": "7202512167722065",
    "canceledAt": "2025-12-16T00:26:15Z"
  }
}
```

[tab:Failure(Already Confirmed)]

```json
{
  "resultCode": "EBP-Z-0006",
  "message": "It has already been confirmed: 7202512107721452",
  "requestId": "1768804946749",
  "timestamp": "2026-01-19T06:42:26.751010900Z",
  "data": {
    "orderNo": "7202512107721452",
    "itemSeq": 0,
    "confirmedAt": null
  }
}
```

[/tabs]