구매 API - 구매 확정 요청 #

1. API Overview #

Purpose #

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

Details #

항목	값
API Name	구매 확정 요청
API Path	/api/v2/payment/confirm
API ID	EBP_API_214
HTTP Method	POST
Region	Global

2. Request Specification #

2.1 Request Header #

상세한 헤더 정보는 Common Headers 문서를 참고하세요.

2.2 Request Data Schema #

depth Field Details & Description

orderNo

depth	Field	Details & Description
0	orderNo	`string` 🔴 Required 주문번호
0	items	`array` 🔴 Required 구매 확정 요청 대상 아이템
1	itemSeq	`string` 🔴 Required 일련번호

string

🔴 Required

주문번호

items

array

🔴 Required

구매 확정 요청 대상 아이템

itemSeq

string

🔴 Required

일련번호

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	`string` 🔴 Required 결과 코드 (성공 "0", 에러 시 "EBP-A-0001" 등)
-1	message	`string` 🔴 Required 결과 메시지 (성공 또는 에러 상세)
-1	requestId	`string` 🔴 Required 추적을 위한 고유 요청 ID
-1	timestamp	`string` 🔴 Required ISO 8601 형식의 응답 타임스탬프 e.g., 2025-12-19T14:24:00+09:00
-1	data	`object` 🔴 Required 응답 데이터
0	orderNo	`string` 🔴 Required 주문번호
0	items	`array` 🔴 Required -
1	itemSeq	`string` 🔴 Required 일련번호
1	resultCode	`string` 🔴 Required 결과코드 e.g., 000:성공]
1	message	`string` 🔴 Required 메세지

3.2 Response Samples #

Success

Failure(Already Canceled)

Failure(Already Confirmed)

{
  "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"
      }
    ]
  }
}

{
  "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
  }
}