# Errors

The EBP API conveys error information through HTTP status codes and the `resultCode` and `error` objects in the response body.

## Error Types

| Type | Error Type            | Description                                                                                          |
|------|-----------------------|------------------------------------------------------------------------------------------------------|
| A    | Authentication Error  | Issues related to authentication keys or unregistered APIs                                           |
| B    | Protocol Format Error | Errors in format, encryption, or mandatory parameter checks                                          |
| C    | Validation Error      | Validation of reference data (e.g., min/max payment amount), member/product validity, payment status |
| D    | Payment Gateway Error | Errors returned from the Payment Gateway                                                             |
| E    | Integration Error     | Errors in integration with multiple systems such as store or EMP                                     |
| Z    | EBP System Error      | Miscellaneous or system-level errors                                                                 |

## Common Error Codes

| Result Code | HTTP Status | Description |
| :--- | :--- | :--- |
| **0** | 200 | Success |
| **EBP-A-0001** | 400 | Authentication Error |
| **EBP-B-0001** | 400 | Invalid Payment Method Registration Info Type |
| **EBP-B-0002** | 400 | Missing Mandatory Payment Method Registration Info |
| **EBP-C-0001** | 400 | Invalid Payment Method Info |
| **EBP-C-0002** | 400 | Invalid Token Info |
| **EBP-C-0003** | 400 | Invalid PIN |
| **EBP-C-0004** | 400 | Validation Failed |
| **EBP-C-0005** | 400 | Other Validation Error |
| **EBP-C-0006** | 400 | Invalid Request Format |
| **EBP-C-0007** | 400 | Schema Mismatch |
| **EBP-C-0008** | 500 | Payment Processing Error |
| **EBP-C-0009** | 500 | Approval Failed |
| **EBP-C-0010** | 500 | Cancellation Failed |
| **EBP-C-0011** | 500 | Retry Recommended |
| **EBP-C-0012** | 500 | System Critical Error |
| **EBP-Z-0001** | 500 | Merchant Error |
| **EBP-Z-0002** | 500 | Order Request Error |
| **EBP-Z-0003** | 500 | Payment Request Error |
| **EBP-Z-0004** | 500 | Payment Approval Error |
| **EBP-Z-0005** | 500 | Payment Cancellation Error |
| **EBP-Z-0010** | 500 | Internal Server Error |

## Error Response Example

### Missing Mandatory Headers (EBP-A-0001)

Occurs when mandatory headers required for the API call are missing.

**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"
      }
    ]
  }
}
```

### Validation Failed (EBP-C-0004)

Occurs when request parameters are invalid. Detailed error information is included in the `error.errorDetails` field.

[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]