s# Purchase API - Confirm Purchase
1. API Overview #
Purpose #
This API requests purchase confirmation.
It confirms the purchase based on the order number and item sequence (seq).
The API is typically used by merchants after delivery is completed.
The request can include one or more items, and upon success, the API returns the result for each item.
Details #
| Item | Value |
|---|---|
| API Name | Confirm Purchase |
| API Path | /api/v2/payment/confirm |
| API ID | EBP_API_214 |
| HTTP Method | POST |
| Region | Global |
2. Request Specification #
2.1 Request Header #
For detailed header information, please refer to the Common Headers documentation.
2.2 Request Data Schema #
| depth | Field | Details & Description |
|---|---|---|
| 0 | orderNo |
🔴 Required Order Number |
| 0 | items |
🔴 Required Purchase confirmation request items |
| 1 | itemSeq |
🔴 Required Sequence number |
2.3 Request Examples #
JSON Example #
{
"orderNo": "1768806886289",
"items": [
{
"itemSeq": 1
},
{
"itemSeq": 2
}
]
}
3. Response Specification #
3.1 Response Data Schema #
| depth | Field | Details & Description |
|---|---|---|
| -1 | resultCode |
🔴 Required Result code e.g., "0" for success, "EBP-A-0001" for error |
| -1 | message |
🔴 Required Result message |
| -1 | requestId |
🔴 Required Unique request identifier for tracking |
| -1 | timestamp |
🔴 Required Response timestamp in ISO 8601 format e.g., 2025-12-19T14:24:00+09:00 |
| -1 | data |
🔴 Required Response data |
| 0 | items |
🔴 Required - |
| 1 | orderNo |
🔴 Required Order Number |
| 1 | itemSeq |
🔴 Required Sequence number |
| 1 | resultCode |
🔴 Required ResultCode e.g., 000: Success |
| 1 | message |
🔴 Required Mssage |
3.2 Response Samples #
{
"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"
}
]
}
}
{
"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"
}
}
{
"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
}
}