# Errors

EBP API는 HTTP 상태 코드와 응답 본문의 `resultCode` 및 `error` 객체를 통해 에러 정보를 전달합니다.

## 에러 유형

| Type | Error Type            | Description                                    |
|------|--------------------|------------------------------------------------|
| A    | 인증 오류          | 인증키, 미등록 API 등                                 |
| B    | 전문규격 오류      | 규격형식, 암호화 오류, 파라미터 필수 체크 등                     |
| C    | 유효성체크 오류    | 기준정보(최소/최대 결제금액 등) 체크, 유효 회원, 유효 상품, 결제상태 체크 등 |
| D    | PG 오류            | PG에서 에러가 전달되는 경우                               |
| E    | 연동 오류          | 스토어, EMP 외 다수 시스템 연동 오류 등                      |
| Z    | EBP 오류           | 기타 및 시스템 오류                                    |

## 공통 에러 코드

| Result Code | HTTP Status | Description       |
| :--- | :--- |:------------------|
| **0** | 200 | 성공                |
| **EBP-A-0001** | 400 | 인증 오류             |
| **EBP-B-0001** | 400 | 결제수단 등록정보 타입 오류   |
| **EBP-B-0002** | 400 | 결제수단 등록정보 필수항목 누락 |
| **EBP-C-0001** | 400 | 결제수단 유효성 검증 실패    |
| **EBP-C-0002** | 400 | 토큰 정보 유효성 검증 실패   |
| **EBP-C-0003** | 400 | 결제 비밀번호 검증 실패     |
| **EBP-C-0004** | 400 | 유효성 검증 실패         |
| **EBP-C-0005** | 400 | 기타 검증 오류          |
| **EBP-C-0006** | 400 | 요청 포맷 오류          |
| **EBP-C-0007** | 400 | 스키마 불일치           |
| **EBP-C-0008** | 500 | 결제 처리 오류          |
| **EBP-C-0009** | 500 | 승인 실패             |
| **EBP-C-0010** | 500 | 취소 실패             |
| **EBP-C-0011** | 500 | 재시도 권고 오류         |
| **EBP-C-0012** | 500 | 시스템 장애 |
| **EBP-Z-0001** | 500 | 가맹점 오류            |
| **EBP-Z-0002** | 500 | 주문 요청 오류          |
| **EBP-Z-0003** | 500 | 결제 요청 오류          |
| **EBP-Z-0004** | 500 | 결제 승인 오류          |
| **EBP-Z-0005** | 500 | 결제 취소 오류          |
| **EBP-Z-0010** | 500 | 시스템 오류            |

## 에러 응답 예시

### 필수 헤더 누락 (EBP-A-0001)

API 호출 시 요구되는 필수 헤더가 누락된 경우 발생합니다.

**Response Body:**

```json
{
  "resultCode": "EBP-A-0001",
  "message": "Missing Mandatory Headers",
  "requestId": "1704201234567",
  "timestamp": "2025-01-02T10:00:00Z",
  "error": {
    "errorDetails": [
      {
        "header": "X-Store-Id",
        "message": "Missing Mandatory Header"
      },
      {
        "header": "X-Country-Code",
        "message": "Missing Mandatory Header"
      }
    ]
  }
}
```

### 유효성 검증 실패 (EBP-C-0004)

요청 파라미터의 값이 유효하지 않은 경우 발생합니다. `error.errorDetails` 필드에 상세 내용이 포함됩니다.

[tabs]
[tab:Single Field Error]
```json
{
    "resultCode": "EBP-C-0004",
    "message": "Validation Failed",
    "requestId": "1767329889073",
    "timestamp": "2026-01-02T04:58:09.073097700Z",
    "data": null,
    "error": {
        "errorDetails": [
            {
                "field": "userNo",
                "message": "The field 'userNo' must not be blank."
            }
        ]
    }
}
```
[tab:Multiple Fields Error]
```json
{
    "resultCode": "EBP-C-0004",
    "message": "Validation Failed",
    "requestId": "1767331147785",
    "timestamp": "2026-01-02T05:19:07.785507100Z",
    "data": null,
    "error": {
        "errorDetails": [
            {
                "field": "paymentMethodCode",
                "message": "The field 'paymentMethodCode' must not be blank."
            },
            {
                "field": "totalAmount",
                "message": "The field 'totalAmount' is required."
            },
            {
                "field": "cancelUrl",
                "message": "The field 'cancelUrl' must not be blank."
            },
            {
                "field": "currency",
                "message": "The field 'currency' must not be blank."
            },
            {
                "field": "successUrl",
                "message": "The field 'successUrl' must not be blank."
            },
            {
                "field": "purchaseChannel",
                "message": "The field 'purchaseChannel' is required."
            }
        ]
    }
}
```
[/tabs]