# 구매 API - 결제 Capture

## 1. API Overview

### Purpose

[context]
결제 승인 후 Capture(매입/정산)를 요청하는 API입니다.<br>주문번호를 기반으로 승인된 결제 금액을 확정하고 정산 처리를 진행합니다.<br>처리 성공 시 해당 주문에 대한 결과를 반환하여 안정적인 정산 프로세스를 보장합니다.
[/context]

### Details

[table:key-value]
| 항목            | 값                      |
| :-------------- | :---------------------- |
| **API Name**    | 결제 Capture            |
| **API Path**    | /api/v2/payment/capture |
| **API ID**      | EBP_API_228             |
| **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     | captureAmount | [type:number] [req:Yes] [desc:캡처 금액]       |

### 2.3 Request Examples

#### JSON Example

```json
{
  "orderNo": "ORD20251224001",
  "captureAmount": 100.0
}
```

## 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     | resultCode | [type:string] [req:Yes]                    |
| 0     | message    | [type:string] [req:Yes]                    |

### 3.2 Response Samples

#### Success Response

```json
{
  "resultCode": "0",
  "message": "SUCCESS",
  "requestId": "1767139979421",
  "timestamp": "2025-12-31T00:12:59.422210900Z",
  "data": {
    "orderNo": "ORD20251224001",
    "resultCode": "000",
    "message": "success"
  }
}
```