s# Purchase API - Confirm Purchase

## 1. API Overview

### Purpose

[context]
This API requests purchase confirmation.<br>It confirms the purchase based on the order number and item sequence (seq).<br>The API is typically used by merchants after delivery is completed.<br>The request can include one or more items, and upon success, the API returns the result for each item.
[/context]

### Details

[table:key-value]
| Item            | Value                   |
| :-------------- | :---------------------- |
| **API Name**    | Confirm Purchase        |
| **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:Order Number]    |
| 0     | items   | [type:array] [req:Yes] [desc:Purchase confirmation request items]                |
| 1     | itemSeq | [type:string] [req:Yes] [desc:Sequence number] |

### 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:Response data]                 |
| 0     | items      | [type:array] [req:Yes] [desc:-]                              |
| 1     | orderNo    | [type:string] [req:Yes] [desc:Order Number]                  |
| 1     | itemSeq    | [type:string] [req:Yes] [desc:Sequence number]               |
| 1     | resultCode | [type:string] [req:Yes] [desc:ResultCode] [eg:000: Success] |
| 1     | message    | [type:string] [req:Yes] [desc:Mssage]                        |

### 3.2 Response Samples

[tabs]
[tab:Success]

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

[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]