에러코드

브라우저 에러코드

브라우저에서 failUrl로 전달되는 에러목록입니다.

에러 코드메시지
PAY_PROCESS_CANCELED사용자에 의해 결제가 취소되었습니다.
PAY_PROCESS_ABORTED결제 진행 중 승인에 실패하여 결제가 중단되었습니다.
REJECT_CARD_COMPANY카드사 승인이 거절되었습니다.

API 에러코드

API에서 발생할 수 있는 에러목록입니다.

HTTP 상태 코드에러 코드메시지
400INVALID_REQUEST잘못된 요청입니다.
400INVALID_CLIENT_KEY잘못된 클라이언트 연동 정보 입니다.
400INVALID_API_KEY잘못된 시크릿키 연동 정보 입니다.
400INVALID_ISO_DATE_FORMAT시간 일시 형식이 잘못되었습니다. 시간 형식은 ISO 8601 형식을 준수해야 합니다.
400INVALID_CASH_RECEIPT_INFO현금 영수증 정보가 잘못되었습니다.
400INVALID_CARD_COMPANY유효하지 않은 카드사입니다.
400INVALID_BANK유효하지 않은 은행입니다.
400INVALID_CARD카드 입력정보가 올바르지 않습니다.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요.\n(유효기간)
400INVALID_PAGING_KEY잘못된 페이징 키 입니다.
400INVALID_CARD_PASSWORD카드 정보를 다시 확인해주세요.\n(비밀번호)
400INVALID_CARD_IDENTITY입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다.
400INVALID_STOPPED_CARD정지된 카드 입니다.
400INVALID_CARD_INSTALLMENT_AMOUNT할부금액 잘못 되었습니다.
400DUPLICATED_ORDER_ID이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.
400INVALID_DATE날짜 데이터가 잘못 되었습니다.
400NOT_MATCHES_REFUNDABLE_AMOUNT잔액 결과가 일치하지 않습니다.
400NOT_SUPPORTED_METHOD지원되지 않는 결제 수단입니다.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.
400NOT_SUPPORTED_CARRIER지원되지 않는 이동 통신사입니다.
400EXCEED_MAX_QUERY_LIMIT최대 조회 개수를 초과했습니다.
400EXCEED_MAX_PAYMENT_AMOUNT하루 결제 가능 금액을 초과했습니다.
400EXCEED_MAX_DAILY_PAYMENT_COUNT하루 결제 가능 횟수를 초과했습니다.
400EXCEED_UNKNOWN_CASE한도 초과 되었습니다.
400EXCEED_MAX_AMOUNT거래금액 한도를 초과했습니다.
400EXCEED_MAX_ONE_TIME_WITHDRAW_AMOUNT1회 출금 한도를 초과했습니다.
400EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT1일 출금 한도를 초과했습니다.
400ALREADY_CANCELED_PAYMENT이미 취소된 결제 입니다.
400INVALID_BIRTH_DAY_FORMAT생년월일 정보는 6자리의 yyMMdd 형식이어야 합니다.
400INVALID_PAYMENT_KEY잘못된 결제 키 입니다.
400INVALID_AUTHORIZE_AUTH_TYPE_GIFT_CERTIFICATE유효하지 않은 상품권 결제 인증 타입입니다.
400INVALID_AUTHORIZE_AUTH잘못된 인증 방식입니다.
400INVALID_IDENTIFICATION_TYPE유효하지 않은 본인 인증 타입입니다.
400INVALID_VIRTUAL_ACCOUNT_TYPE유효하지 않은 가상계좌 타입입니다.
400INVALID_BILLING_AUTH유효하지 않은 빌링 인증입니다.
400INVALID_CUSTOMER_KEY고객키는 영문 대소문자, 숫자, 특수문자 -, *, =, ., @로 2자 이상 255자 이하여야 합니다.
400INVALID_ORDER_ID주문번호는 영문 대소문자, 숫자, 특수문자 -, *, =로 6자 이상 64자 이하여야 합니다.
400INVALID_ORDER_NAME주문 이름은 100자 이하여야 합니다.
400INVALID_EMAIL이메일 주소 형식에 맞지 않습니다.
400INVALID_SUCCESS_URLsuccessUrl 값은 필수 값입니다.
400INVALID_URLurl 은 http, https 를 포함한 주소 형식이어야 합니다.
400INVALID_URL_FORMAT잘못된 URL 형식입니다.
400INVALID_BILL_KEY_REQUEST빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다.
400INVALID_CARD_INSTALLMENT_PLANS_WITH_MAX_AND_SINGLEcardInstallmentPlan과 maxCardInstallmentPlan은 같이 사용할 수 없습니다.
400INVALID_VALID_HOURS_WITH_DUE_DATE_AND_SINGLEvalidHours와 dueDate는 같이 사용할 수 없습니다.
400INVALID_ACCOUNT_NOT_CORRECT_BANK입력하신 계좌는 해당 은행의 계좌가 아닙니다.
400INVALID_EASY_PAY간편결제 입력정보가 올바르지 않습니다.
400INVALID_CURRENCY잘못된 통화 값입니다.
400INVALID_FLOW_MODE_PARAMETERS인증 창을 먼저 띄우려면 카드사 코드 또는 은행 코드 또는 간편결제 수단이 같이 전달되어야 합니다.
400INVALID_BUSINESS_NUMBER사업자 등록번호가 잘못되었습니다.
400INVALID_ACCOUNT_NUMBER계좌번호가 올바르지 않습니다.
400INVALID_ACCOUNT_NUMBER_OR_UNAVAILABLE잘못된 계좌번호이거나 서비스 불가한 계좌입니다.
400INVALID_PAYABLE_DATE지급일자가 올바르지 않습니다.
400INVALID_REJECT_CARD카드사에 문의 바랍니다.
400DUPLICATED_REQUEST중복된 요청입니다.
400NOT_SUPPORTED_PROCESS지원되지 않는 작업입니다.
400NOT_ALLOWED_SKIP_AUTH운영 환경에서는 _skipAuth 플래그 사용이 불가능합니다.
400NOT_SUPPORTED_USD선택하신 카드 또는 결제수단은 달러 결제가 불가합니다.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부 또는 무이자 할부가 지원되지 않는 카드입니다.
400NOT_FOUND_TERMINAL_ID단말기번호(Terminal Id)가 없습니다. 토스페이먼츠로 문의 바랍니다.
400NOT_REGISTERED_SUBMALLPG 하위몰 사업자번호가 등록되어 있지 않습니다.
400NOT_REGISTERED_BUSINESS미등록된 사업자 입니다.
400NOT_ALLOWED_POINT_USE포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다.
400NOT_ALLOWED_INSTALLMENT_BELOW_AMOUNT해당 카드는 10000원 미만 할부 거래가 불가한 카드입니다.
400NOT_ALLOWED_HOLIDAY공휴일은 지급일로 선택할 수 없습니다.
400NOT_MATCHES_CUSTOMER_KEY빌링 인증 고객키와 결제 요청 고객키가 일치하지 않습니다.
400NOT_ENOUGH_AMOUNT지급가능한 금액을 초과했습니다.
400EXCEED_MAX_VALID_HOURS가상 계좌의 최대 유효시간을 초과했습니다.
400EXCEED_MAX_DUE_DATE가상 계좌의 최대 유효만료 기간을 초과했습니다.
400EXCEED_MAX_CARD_INSTALLMENT_PLAN설정 가능한 최대 할부 개월 수를 초과했습니다.
400EXCEED_MIN_CARD_INSTALLMENT_PLAN설정 가능한 최소 할부 개월 수를 1개월 이상으로 설정해주세요.
400BELOW_MINIMUM_AMOUNT신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.
400BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.
400REQUIRED_AMOUNT금액 값이 필수입니다.
400REQUIRED_ACCOUNT_KEY고정계좌는 발급용 고객키 값이 필수입니다.
400ACCOUNT_OWNER_CHECK_FAILED계좌 소유주를 가져오는데 실패했습니다. 은행코드, 계좌번호를 확인해주세요.
400INVALID_SUBMALL_ID유효하지 않은 서브몰 ID 입니다. 영문, 숫자 20글자 이하로 입력해주세요.
400INVALID_UNREGISTERED_SUBMALL미등록된 PG 하위몰 이거나 단독가맹점은 안심클릭/ISP 결제가 필요합니다.
400NOT_MATCH_PAYEE_NAME수취인 성명이 불일치 합니다.
400ALREADY_COMPLETED_PAYMENT이미 완료된 결제 입니다.
400ALREADY_PROCESSED_PAYMENT이미 처리된 결제 입니다.
400ALREADY_EXIST_SUBMALL이미 존재하는 서브몰입니다.
400ALREADY_CLOSE_ACCOUNT이미 해지된 계좌입니다.
400PAY_PROCESS_CANCELED결제가 사용자에 의해 취소되었습니다.
400PAY_PROCESS_ABORTED결제가 취소되었거나 진행되지 않았습니다.
400ALREADY_REFUND_PAYMENT이미 환불된 결제입니다.
400ALREADY_REFUNDING_PAYMENT이미 환불 중인 결제입니다.
400INVALID_REFUND_ACCOUNT_NUMBER잘못된 환불 계좌번호입니다.
400INVALID_REFUND_AMOUNT잘못된 환불 금액입니다.
400INVALID_REFUND_ACCOUNT_INFO환불 계좌번호와 예금주명이 일치하지 않습니다.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.
403UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.
403NOT_CANCELABLE_PAYMENT취소 할 수 없는 결제 입니다.
403NOT_CANCELABLE_AMOUNT취소 할 수 없는 금액 입니다.
403REJECT_CARD_COMPANY카드 잔액이 부족하거나 재발급 등으로 결제 승인이 거절되었습니다.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.
403INVALID_PASSWORD결제 비밀번호가 일치하지 않습니다.
403NOT_SUPPORTED_REFUND환불 가능한 상점이 아닙니다.
403NOT_AVAILABLE_BANK은행 서비스 시간이 아닙니다.
403NOT_ALLOWED_REFUND_BANK환불 가능한 은행이 아닙니다.
403NOT_ALLOWED_PARTIAL_REFUND에스크로 주문, 현금 카드 결제 등의 사유로 부분 환불이 불가합니다.
403NOT_ALLOWED_PARTIAL_REFUND_WAITING_DEPOSIT입금 대기중인 결제는 부분 환불이 불가합니다.
403NOT_ALLOWED_CHANGING_ACCOUNT이미 입금, 반납된 계좌의 정보 변경은 불가합니다.
403EXCEED_MAX_REFUND_DUE환불 가능한 기간이 초과했습니다.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.
403EXCEED_MAX_REFUND_AMOUNT하루 또는 한달 환불 가능한 금액을 초과했습니다.
404NOT_FOUND존재하지 않는 정보 입니다.
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.
404NOT_FOUND_MERCHANT존재하지 않는 상점 정보 입니다.
404NOT_FOUND_MERCHANT_INTEGRATION존재하지 않는 상점 연동 정보 입니다.
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.
404NOT_FOUND_METHOD_OWNERSHIP결제수단의 소유자가 아닙니다.
404NOT_FOUND_METHOD_IN_GROUP같은 그룹내에 존재하지 않는 결제 수단 입니다.
404NOT_FOUND_PAYMENT_SESSION결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다.
404NOT_FOUND_HTTP_METHOD존재하지 않는 HTTP 메소드 접근입니다.
404NOT_FOUND_BILLING존재하지 않는 빌링 결제 인증 정보 입니다.
404NOT_FOUND_SUBMALL존재하지 않는 서브몰입니다.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.
500FAILED_HASH_DATA_CREATION해시 데이터 생성 중 오류가 발생했습니다.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.
500UNKNOWN_ERROR확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요.
500FAILED_REFUND_PROCESS은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다.
500FAILED_BILL_KEY_AUTH_CREATION빌링 결제 인증 중 키 생성에 실패했습니다. 잠시 후 다시 시도해주세요.
500FAILED_METHOD_HANDLING결제 중 선택한 결제 수단 처리에 일시적인 오류가 발생했습니다.
500FAILED_METHOD_HANDLING_CANCEL취소 중 결제 시 사용한 결제 수단 처리과정에서 일시적인 오류가 발생했습니다.
500FAILED_BILLING_AUTO_CANCEL빌링 자동결제 취소에 일시적인 오류가 발생했습니다.

구 모듈 에러코드

기존 전자결제 연동 모듈의 에러코드는 아래 링크에서 확인할 수 있습니다.

구 모듈 에러코드

  • 더 궁금한 내용이 있나요?자주 묻는 질문
  • 코드 샘플을 참고하세요TossPayments GitHub
  • 기술지원이 필요한가요?디스코드 채팅|이메일 보내기