구매 API - 결제 승인 #
1. API Overview #
Purpose #
결제 요청(EBP_API_224) 호출 후 사용자가 결제를 진행하면, PG에서 EBP를 통해 상점에 결제 완료 정보가 전달됩니다. 스토어는 최종 결제완료 처리를 위해 본 API를 호출합니다. 이 API는 화면 전환 없이 결제승인 완료를 처리하기 위해 제공됩니다.
Details #
| 항목 | 값 |
|---|---|
| API Name | 결제 승인 |
| API Path | /api/v2/payment/approve |
| API ID | EBP_API_242 |
| HTTP Method | POST |
| Region | Korea Only |
2. Request Specification #
2.1 Request Header #
상세한 헤더 정보는 Common Headers 문서를 참고하세요.
2.2 Request Data Schema #
| Field | Type | Required | Description |
|---|---|---|---|
| - | - | - | - |
2.3 Request Examples #
JSON Example #
{}
3. Response Specification #
3.1 Response Data Schema #
Response Data Schema #
| depth | Field | Details & Description |
|---|---|---|
| -1 | resultCode |
🔴 Required 결과 코드 (성공 "0", 에러 시 "EBP-A-0001" 등) |
| -1 | message |
🔴 Required 결과 메시지 (성공 또는 에러 상세) |
| -1 | requestId |
🔴 Required 추적을 위한 고유 요청 ID |
| -1 | timestamp |
🔴 Required ISO 8601 형식의 응답 타임스탬프 e.g., 2025-12-19T14:24:00+09:00 |
| -1 | data |
null |
이 API는
data필드에 별도의 데이터를 반환하지 않습니다.
3.2 Response Samples #
Success Response #
{
"resultCode": "0",
"message": "success",
"requestId": "RES-25-101982-0001",
"timestamp": "2025-12-19T14:29:32+09:00",
"data": null
}