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:

{
  "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 필드에 상세 내용이 포함됩니다.

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