Skip to Content
레퍼런스API 에러 코드 일람

API 에러 코드 일람

T사 에러 코드 일람과 호환성을 제공해요.

export const KnownErrors = { ALREADY_CANCELED_PAYMENT: [400, '이미 취소된 결제입니다.'], ALREADY_COMPLETED_PAYMENT: [ 400, '이미 완료된 결제입니다.', '(참고) 이미 승인 실패한 결제도 본 에러코드로 출력됩니다. 새 결제를 생성해주세요.', ], ALREADY_PROCESSED_PAYMENT: [400, '이미 처리된 결제입니다.'], ALREADY_REFUND_PAYMENT: [400, '이미 환불된 결제입니다.'], BELOW_MINIMUM_AMOUNT: [ 400, '신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.', ], BELOW_ZERO_AMOUNT: [400, '금액은 0보다 커야 합니다.'], DUPLICATED_ORDER_ID: [ 400, '이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.', ], DUPLICATED_REQUEST: [400, '중복된 요청입니다.'], EXCEED_MIN_CARD_INSTALLMENT_PLAN: [ 400, '설정 가능한 최소 할부 개월 수를 1개월 이상으로 설정해주세요.', ], EXCEED_UNKNOWN_CASE: [400, '한도 초과 되었습니다.'], INVALID_API_KEY: [400, '잘못된 시크릿키 연동 정보 입니다.'], INVALID_AUTHORIZE_AUTH: [400, '잘못된 인증 방식입니다.'], INVALID_AUTHORIZE_AUTH_TYPE_GIFT_CERTIFICATE: [400, '유효하지 않은 상품권 결제 인증 타입입니다.'], INVALID_BANK: [400, '유효하지 않은 은행입니다.'], INVALID_BIRTH_DAY_FORMAT: [ 400, '생년월일 정보는 6자리의 yyMMdd 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다.', ], INVALID_BUSINESS_NUMBER: [400, '사업자 등록번호가 잘못되었습니다.'], INVALID_CARD: [400, '카드 입력정보가 올바르지 않습니다.'], INVALID_CARD_INSTALLMENT_AMOUNT: [400, '할부금액 잘못 되었습니다.'], INVALID_CASH_RECEIPT_INFO: [400, '현금 영수증 정보가 잘못되었습니다.'], INVALID_CLIENT_KEY: [400, '잘못된 클라이언트 연동 정보 입니다.'], INVALID_CUSTOMER_KEY: [ 400, 'customerKey는 영문 대소문자, 숫자, 특수문자 -, *, =, ., @로 2자 이상 255자 이하여야 합니다.', ], INVALID_DATE: [400, '날짜 데이터가 잘못 되었습니다.'], INVALID_IDENTIFICATION_TYPE: [400, '유효하지 않은 본인 인증 타입입니다.'], INVALID_ISO_DATE_FORMAT: [ 400, '시간 일시 형식이 잘못되었습니다. 시간 형식은 ISO 8601 형식을 준수해야 합니다.', ], INVALID_ORDER_ID: [ 400, 'orderId는 영문 대소문자, 숫자, 특수문자(-, _) 만 허용합니다. 16자 이상 50자 이하여야 합니다.', ], INVALID_ORDER_NAME: [400, '주문 이름은 100자 이하여야 합니다.'], INVALID_PAYMENT_KEY: [400, '잘못된 결제 키 입니다.'], INVALID_REJECT_CARD: [400, '카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.'], INVALID_REQUEST: [400, '잘못된 요청입니다.'], INVALID_REQUIRED_PARAM: [400, '필수 파라미터가 누락되었습니다.'], INVALID_STOPPED_CARD: [400, '정지된 카드 입니다.'], INVALID_SUBMALL_ID: [ 400, '유효하지 않은 서브몰 ID 입니다. 영문, 숫자 20글자 이하로 입력해주세요.', ], INVALID_SUCCESS_URL: [400, 'successUrl 값은 필수 값입니다.'], INVALID_TEST_CODE: [400, '유효하지 않은 테스트 코드입니다.'], INVALID_UNREGISTERED_SUBMALL: [ 400, '미등록된 PG 하위몰 이거나 단독가맹점은 안심클릭/ISP 결제가 필요합니다.', ], INVALID_URL: [400, 'url 은 http, https 를 포함한 주소 형식이어야 합니다.'], MAINTAINED_METHOD: [400, '현재 점검 중 입니다.'], NOT_SUPPORTED_CARD_TYPE: [400, '지원되지 않는 카드 종류입니다.'], NOT_SUPPORTED_CARRIER: [400, '지원되지 않는 이동 통신사입니다.'], NOT_SUPPORTED_METHOD: [400, '지원되지 않는 결제수단입니다.'], NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN: [ 400, '할부 또는 무이자 할부가 지원되지 않는 카드입니다.', ], PAY_PROCESS_ABORTED: [400, '결제가 취소되었거나 진행되지 않았습니다.'], PAY_PROCESS_CANCELED: [400, '결제가 사용자에 의해 취소되었습니다.'], REFUND_REJECTED: [400, '환불이 거절됐습니다. 결제사에 문의 부탁드립니다.'], UNAUTHORIZED_KEY: [401, '인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.'], EXCEED_MAX_AUTH_COUNT: [403, '최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.'], EXCEED_MAX_REFUND_AMOUNT: [403, '하루 또는 한달 환불 가능한 금액을 초과했습니다.'], EXCEED_MAX_REFUND_DUE: [403, '환불 가능한 기간이 초과했습니다.'], FORBIDDEN_CONSECUTIVE_REQUEST: [ 403, '반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요.', ], FORBIDDEN_REQUEST: [403, '허용되지 않은 요청입니다.'], NOT_ALLOWED_CHANGING_ACCOUNT: [403, '이미 입금, 반납된 계좌의 정보 변경은 불가합니다.'], NOT_ALLOWED_PARTIAL_REFUND: [ 403, '에스크로 주문, 현금 카드 결제 등의 사유로 부분 환불이 불가합니다.', ], NOT_ALLOWED_PARTIAL_REFUND_WAITING_DEPOSIT: [403, '입금 대기중인 결제는 부분 환불이 불가합니다.'], NOT_ALLOWED_REFUND_BANK: [403, '환불 가능한 은행이 아닙니다.'], NOT_CANCELABLE_AMOUNT: [403, '취소 할 수 없는 금액 입니다.'], NOT_CANCELABLE_PAYMENT: [403, '취소 할 수 없는 결제 입니다.'], REJECT_ACCOUNT_PAYMENT: [403, '잔액부족으로 결제에 실패했습니다.'], REJECT_CARD_COMPANY: [403, '결제 승인이 거절되었습니다.'], NOT_FOUND: [404, '존재하지 않는 정보 입니다.'], NOT_FOUND_BILLING: [404, '존재하지 않는 빌링 결제 인증 정보 입니다.'], NOT_FOUND_HTTP_METHOD: [404, '존재하지 않는 HTTP 메소드 접근입니다.'], NOT_FOUND_MERCHANT: [404, '존재하지 않는 상점 정보 입니다.'], NOT_FOUND_MERCHANT_INTEGRATION: [404, '존재하지 않는 상점 연동 정보 입니다.'], NOT_FOUND_METHOD: [404, '존재하지 않는 결제수단 입니다.'], NOT_FOUND_METHOD_IN_GROUP: [404, '같은 그룹내에 존재하지 않는 결제수단 입니다.'], NOT_FOUND_METHOD_OWNERSHIP: [404, '결제수단의 소유자가 아닙니다.'], NOT_FOUND_PAYMENT: [404, '존재하지 않는 결제 정보 입니다.'], NOT_FOUND_PAYMENT_SESSION: [404, '결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다.'], FAILED_DB_PROCESSING: [500, '잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.'], FAILED_INTERNAL_SYSTEM_PROCESSING: [ 500, '내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.', ], FAILED_METHOD_HANDLING: [500, '결제 중 선택한 결제수단 처리에 일시적인 오류가 발생했습니다.'], FAILED_METHOD_HANDLING_CANCEL: [ 500, '취소 중 결제 시 사용한 결제수단 처리과정에서 일시적인 오류가 발생했습니다.', ], COMMON_ERROR: [500, '일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.'], UNKNOWN_ERROR: [500, '확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요.'], } as const
Last updated on