# Purchase API - Capture Payment

## 1. API Overview

### Purpose

[context]
This API is used to request a Capture (settlement) after payment authorization.<br>It finalizes the authorized payment amount and processes the settlement based on the order number.<br>After processing the capture, the API returns the result to the merchant to ensure a secure settlement process.
[/context]

### Details

[table:key-value]
| Item            | Value                   |
| :-------------- | :---------------------- |
| **API Name**    | Capture Payment         |
| **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:Capture Amount] |

### 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:Response data] |
| 0     | orderNo    | [type:string] [req:Yes] [desc:Order Number]  |
| 0     | resultCode | [type:string] [req:Yes] [desc:-]             |
| 0     | message    | [type:string] [req:Yes] [desc:-]             |

### 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"
  }
}
```