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:

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

Single Field Error

Multiple Fields Error

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

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