API & SDK/에러 코드
목차

토스페이먼츠 API를 사용할 때 발생할 수 있는 에러를 살펴보세요.

에러 객체

요청이 정상적으로 처리되지 않으면 응답으로 HTTP 상태 코드와 함께 아래와 같은 에러 객체가 돌아옵니다.

  • code: 에러 타입을 보여주는 에러 코드입니다.
  • message: 에러 메시지입니다. 에러 발생 이유를 알려줍니다.

이미 일어난 결제 기록을 조회했을 때는 Payment 객체의 failure필드에 에러 객체가 들어있습니다.

코어 API 별 에러

결제 승인

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ALREADY_PROCESSED_PAYMENT이미 처리된 결제 입니다.This is a payment that has already been processed.
400PROVIDER_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.
400EXCEED_MAX_CARD_INSTALLMENT_PLAN설정 가능한 최대 할부 개월 수를 초과했습니다.Maximum number of installment months exceeded. (`installmentPlanMonths`)
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400NOT_ALLOWED_POINT_USE포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다.Card point payment failed because the card cannot be used points.
400INVALID_API_KEY잘못된 시크릿키 연동 정보 입니다.Incorrect secret key.
400INVALID_REJECT_CARD카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.Refer to card issuer/decline.
400BELOW_MINIMUM_AMOUNT신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.Payment can be made from 100 won or more by credit card, and 200 won or more for account.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요. (유효기간)Please check the card expiration date information again.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400EXCEED_MAX_DAILY_PAYMENT_COUNT하루 결제 가능 횟수를 초과했습니다.You have exceeded the number of daily payments.
400NOT_SUPPORTED_INSTALLMENT_PLAN_CARD_OR_MERCHANT할부가 지원되지 않는 카드 또는 가맹점 입니다.This card or merchant does not support installment.
400INVALID_CARD_INSTALLMENT_PLAN할부 개월 정보가 잘못되었습니다.The installment month information is incorrect.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부가 지원되지 않는 카드입니다.This card does not support installment.
400EXCEED_MAX_PAYMENT_AMOUNT하루 결제 가능 금액을 초과했습니다.You have exceeded the amount you can pay per day.
400NOT_FOUND_TERMINAL_ID단말기번호(Terminal Id)가 없습니다. 토스페이먼츠로 문의 바랍니다.There is no Terminal Id. Please contact Toss Payments.
400INVALID_AUTHORIZE_AUTH유효하지 않은 인증 방식입니다.Invalid authentication
400INVALID_CARD_LOST_OR_STOLEN분실 혹은 도난 카드입니다.This is a lost or stolen card
400RESTRICTED_TRANSFER_ACCOUNT계좌는 등록 후 12시간 뒤부터 결제할 수 있습니다. 관련 정책은 해당 은행으로 문의해주세요.You can withdraw from this bank account after 12 hours from initial register. For related policies, please contact your bank.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_UNREGISTERED_SUBMALL등록되지 않은 서브몰입니다. 서브몰이 없는 가맹점이라면 안심클릭이나 ISP 결제가 필요합니다.Not registered PG sub-mall business number.
400NOT_REGISTERED_BUSINESS등록되지 않은 사업자 번호입니다.Unregistered business registration number
400EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT1일 출금 한도를 초과했습니다.You have exceeded the one-day withdrawal limit.
400EXCEED_MAX_ONE_TIME_WITHDRAW_AMOUNT1회 출금 한도를 초과했습니다.You have exceeded the one-time withdrawal limit.
400CARD_PROCESSING_ERROR카드사에서 오류가 발생했습니다.The card company was not able to process the request.
400EXCEED_MAX_AMOUNT거래금액 한도를 초과했습니다.The transaction amount limit has been exceeded.
400INVALID_ACCOUNT_INFO_RE_REGISTER유효하지 않은 계좌입니다. 계좌 재등록 후 시도해주세요.Invalid account. Please re-register the account and try again.
400NOT_AVAILABLE_PAYMENT결제가 불가능한 시간대입니다Payment is unavailable at this time.
400UNAPPROVED_ORDER_ID아직 승인되지 않은 주문번호입니다.This order id has not been approved for payment.
400EXCEED_MAX_MONTHLY_PAYMENT_AMOUNT당월 결제 가능금액인 1,000,000원을 초과 하셨습니다.You have exceeded the allowed monthly payment amount of 1,000,000 KRW.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment declined due to insufficient balance.
403REJECT_CARD_PAYMENT한도초과 혹은 잔액부족으로 결제에 실패했습니다.Payment failed due to limit exceeded or insufficient balance.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment confirm is rejected
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.Not allowed request
403REJECT_TOSSPAY_INVALID_ACCOUNT선택하신 출금 계좌가 출금이체 등록이 되어 있지 않아요. 계좌를 다시 등록해 주세요.Your account invalidated. Please register another account.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.Maximum authentication attempts exceeded.
403EXCEED_MAX_ONE_DAY_AMOUNT일일 한도를 초과했습니다.You have exceeded your daily limit.
403NOT_AVAILABLE_BANK은행 서비스 시간이 아닙니다.It's not banking hour.
403INVALID_PASSWORD결제 비밀번호가 일치하지 않습니다.Incorrect password
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
403FDS_ERROR[토스페이먼츠] 위험거래가 감지되어 결제가 제한됩니다. 발송된 문자에 포함된 링크를 통해 본인인증 후 결제가 가능합니다. (고객센터: 1644-8051)A fraudulent transaction has been detected. To complete the payment, complete the authentication process through the link included in the text message. (Customer Service: 1644-8051)
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.Not found payment
404NOT_FOUND_PAYMENT_SESSION결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다.Payment session does not exist because the session time has expired.
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제가 완료되지 않았어요. 다시 시도해주세요.Payment has not been completed. please try again.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.
500UNKNOWN_PAYMENT_ERROR결제에 실패했어요. 같은 문제가 반복된다면 은행이나 카드사로 문의해주세요.Payment failed. If the same problem occurs, please contact your bank or credit card company.

결제 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN_BELOW_AMOUNT5만원 이하의 결제는 할부가 불가능해서 결제에 실패했습니다.Payment failed because an installment plan was applied to a transaction less than 50,000 won.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403FORBIDDEN_CONSECUTIVE_REQUEST반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요.Repetitive requests are not allowed. Please try again in a few minutes.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.Not found payment
404NOT_FOUND존재하지 않는 정보 입니다.Not found information
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제가 완료되지 않았어요. 다시 시도해주세요.Payment has not been completed. please try again.

결제 취소

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ALREADY_CANCELED_PAYMENT이미 취소된 결제 입니다.The payment has already been canceled.
400INVALID_REFUND_ACCOUNT_INFO환불 계좌번호와 예금주명이 일치하지 않습니다.`accountNumber` and holderName is not matched.
400EXCEED_CANCEL_AMOUNT_DISCOUNT_AMOUNT즉시할인금액보다 적은 금액은 부분취소가 불가능합니다.The cancel amount cannot exceed discount amount
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_REFUND_ACCOUNT_NUMBER잘못된 환불 계좌번호입니다.Incorrect `accountNumber`
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400NOT_MATCHES_REFUNDABLE_AMOUNT잔액 결과가 일치하지 않습니다.Balance results do not match.
400PROVIDER_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.
400REFUND_REJECTED환불이 거절됐습니다. 결제사에 문의 부탁드립니다.The refund has been rejected. Please contact the respective payment provider.
400ALREADY_REFUND_PAYMENT이미 환불된 결제입니다.The payment has been refunded.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403NOT_CANCELABLE_AMOUNT취소 할 수 없는 금액 입니다.This is a non-cancelable amount.
403FORBIDDEN_CONSECUTIVE_REQUEST반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요.Repetitive requests are not allowed. Please try again in a few minutes.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.Not allowed request
403NOT_CANCELABLE_PAYMENT취소 할 수 없는 결제 입니다.This is a non-cancelable payment.
403EXCEED_MAX_REFUND_DUE환불 가능한 기간이 지났습니다.Refundable date has passed.
403NOT_ALLOWED_PARTIAL_REFUND_WAITING_DEPOSIT입금 대기중인 결제는 부분 환불이 불가합니다.Partial refund is not available while pending deposit.
403NOT_ALLOWED_PARTIAL_REFUND에스크로 주문, 현금 카드 결제일 때는 부분 환불이 불가합니다. 이외 다른 결제 수단에서 부분 취소가 되지 않을 때는 토스페이먼츠에 문의해 주세요.Escrow orders or debit card payments cannot be partially canceled. If you are unable to partially cancel your order with any other payment method, please contact Tosspayments.
403NOT_AVAILABLE_BANK은행 서비스 시간이 아닙니다.It's not banking hour.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
403NOT_CANCELABLE_PAYMENT_FOR_DORMANT_USER휴면 처리된 회원의 결제는 취소할 수 없습니다.This is a non-cancelable payment. It is a dormant user account.
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.Not found payment
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.
500FAILED_REFUND_PROCESS은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다.The refund request failed due to a delay in the bank response time or a temporary error.
500FAILED_METHOD_HANDLING_CANCEL취소 중 결제 시 사용한 결제 수단 처리과정에서 일시적인 오류가 발생했습니다.A temporary error occurred while processing cancellation.
500FAILED_PARTIAL_REFUND은행 점검, 해약 계좌 등의 사유로 부분 환불이 실패했습니다.Partial refund failed due to bank check, account canceled, etc.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제가 완료되지 않았어요. 다시 시도해주세요.Payment has not been completed. please try again.

카드 번호 결제

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요. (유효기간)Please check the card expiration date information again.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_CARD_PASSWORD카드 정보를 다시 확인해주세요. (비밀번호)Please check the card information again.
400INVALID_CARD_IDENTITY입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다.The entered resident registration number/business number does not match the cardholder information.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400INVALID_REJECT_CARD카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.Refer to card issuer/decline.
400INVALID_BIRTH_DAY_FORMAT생년월일 정보는 6자리의 `yyMMdd` 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다.Birth dates must be 6 digits long and in a `yyMMdd` format. Business number must be a 10 digit number.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
400NOT_REGISTERED_CARD_COMPANY카드를 사용 등록 후 이용해주세요.Please register the credit card before using it.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부가 지원되지 않는 카드입니다.This card does not support installment.
400INVALID_CARD_INSTALLMENT_PLAN할부 개월 정보가 잘못되었습니다.The installment month information is incorrect.
400NOT_SUPPORTED_INSTALLMENT_PLAN_CARD_OR_MERCHANT할부가 지원되지 않는 카드 또는 가맹점 입니다.This card or merchant does not support installment.
400INVALID_EMAIL유효하지 않은 이메일 주소 형식입니다.Invalid email format
400BELOW_MINIMUM_AMOUNT신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.Payment can be made from 100 won or more by credit card, and 200 won or more for account.
400DUPLICATED_ORDER_ID이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id.
400INVALID_ORDER_ID`orderId`는 영문 대소문자, 숫자, 특수문자(-, _) 만 허용합니다. 6자 이상 64자 이하여야 합니다.`orderId` must be at least 6 and maximum 64 characters including upper and lower case alphabets, numbers, special characters (-, _).
400NOT_ALLOWED_POINT_USE포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다.Card point payment failed because the card cannot be used points.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The required parameter is missing.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN_BELOW_AMOUNT5만원 이하의 결제는 할부가 불가능해서 결제에 실패했습니다.Payment failed because an installment plan was applied to a transaction less than 50,000 won.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403REJECT_CARD_PAYMENT한도초과 혹은 잔액부족으로 결제에 실패했습니다.Payment failed due to limit exceeded or insufficient balance.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.Maximum authentication attempts exceeded.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment declined due to insufficient balance.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment confirm is rejected
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.A DB error occurred while processing with an invalid request value.
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제가 완료되지 않았어요. 다시 시도해주세요.Payment has not been completed. please try again.
500FAILED_CARD_COMPANY_RESPONSE카드사에서 에러가 발생했습니다. 잠시 후 다시 시도해 주세요.An error occurred at the card company. Please try again in a few minutes.

가상계좌 발급 요청

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400DUPLICATED_ORDER_ID이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_REGISTRATION_NUMBER_TYPE유효하지 않은 등록 번호 타입입니다.Invalid registration number type
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400EXCEED_MAX_DUE_DATE가상 계좌의 최대 유효만료 기간을 초과했습니다.Valid time for virtual account exceeded. (`dueDate`)
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.A DB error occurred while processing with an invalid request value.

카드 자동결제 빌링키 발급 요청

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
400INVALID_CARD_PASSWORD카드 정보를 다시 확인해주세요. (비밀번호)Please check the card information again.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요. (유효기간)Please check the card expiration date information again.
400INVALID_CARD_IDENTITY입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다.The entered resident registration number/business number does not match the cardholder information.
400INVALID_REJECT_CARD카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.Refer to card issuer/decline.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400INVALID_BIRTH_DAY_FORMAT생년월일 정보는 6자리의 `yyMMdd` 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다.Birth dates must be 6 digits long and in a `yyMMdd` format. Business number must be a 10 digit number.
400NOT_REGISTERED_CARD_COMPANY카드를 사용 등록 후 이용해주세요.Please register the credit card before using it.
400INVALID_EMAIL유효하지 않은 이메일 주소 형식입니다.Invalid email format
400NOT_SUPPORTED_METHOD지원되지 않는 결제 수단입니다.This payment method is not supported.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.Maximum authentication attempts exceeded.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment confirm is rejected
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment declined due to insufficient balance.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.

카드 자동결제 승인

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400INVALID_REJECT_CARD카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.Refer to card issuer/decline.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요. (유효기간)Please check the card expiration date information again.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_BILL_KEY_REQUEST빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다.Unauthorized billingKey or invalid billing transaction
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
400DUPLICATED_ORDER_ID이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id.
400NOT_SUPPORTED_INSTALLMENT_PLAN_CARD_OR_MERCHANT할부가 지원되지 않는 카드 또는 가맹점 입니다.This card or merchant does not support installment.
400INVALID_CARD_INSTALLMENT_PLAN할부 개월 정보가 잘못되었습니다.The installment month information is incorrect.
400NOT_MATCHES_CUSTOMER_KEY빌링 인증 고객키와 결제 요청 고객키가 일치하지 않습니다.`customerKey` between billing auth request and payment request is not matching.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400BELOW_MINIMUM_AMOUNT신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.Payment can be made from 100 won or more by credit card, and 200 won or more for account.
400NOT_REGISTERED_CARD_COMPANY카드를 사용 등록 후 이용해주세요.Please register the credit card before using it.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부가 지원되지 않는 카드입니다.This card does not support installment.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403REJECT_CARD_PAYMENT한도초과 혹은 잔액부족으로 결제에 실패했습니다.Payment failed due to limit exceeded or insufficient balance.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment declined due to insufficient balance.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment confirm is rejected
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.Maximum authentication attempts exceeded.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.A DB error occurred while processing with an invalid request value.
500FAILED_CARD_COMPANY_RESPONSE카드사에서 에러가 발생했습니다. 잠시 후 다시 시도해 주세요.An error occurred at the card company. Please try again in a few minutes.

거래 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.
400INVALID_TRANSACTION_KEY잘못된 페이징 키 입니다.Bad paging key.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.

정산 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.
  • 에러 코드로 INVALID_REQUEST가 돌아왔다면 dateType이 제대로 들어갔는지 확인해보세요.

수동 정산

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_REQUEST잘못된 요청입니다.The bad request.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.Not allowed request
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.Not found payment
404NOT_FOUND존재하지 않는 정보 입니다.Not found information
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.Not found payment method

현금영수증 발급 요청

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400PROVIDER_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.
400DUPLICATED_CASH_RECEIPT이미 현금영수증이 발급된 주문입니다.This is a duplicate request that has already been issued.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The required parameter is missing.
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제가 완료되지 않았어요. 다시 시도해주세요.Payment has not been completed. please try again.

현금영수증 발급 취소 요청

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.Not allowed request
404NOT_FOUND_RECEIPT존재하지 않는 현금영수증 정보 입니다.Cash receipt information does not exist.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.

현금영수증 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400API_VERSION_UPDATE_NEEDED이 API를 사용하려면 [2022-07-27] 이상의 버전을 사용해야 합니다. 개발자센터(https://developers.tosspayments.com)에서 버전을 변경해주세요.To use the api need to upgrade version to [2022-07-27]. You can update api version at Tosspayment Developer Center(https://developers.tosspayments.com)
400INVALID_BUSINESS_NUMBER사업자 번호는 10자리여야 합니다.The business number must be 10 digits long.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The required parameter is missing.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.

현금영수증 국세청 에러

에러 코드한글 에러 메시지영문 에러 메시지
NTS_ERROR[TS1] 신분확인정보 자릿수 오류[TS1] Incorrect customer identity number length
NTS_ERROR[TS2] 카드정보 자릿수 오류[TS2] Incorrect card number length
NTS_ERROR[TS3] 제외업종사업자와 거래한 현금결제내역[TS3] Cash transaction with a business not eligible for tax reduction
NTS_ERROR[TS4] 매출금액 입력오류 또는 거래금액 총합계 입력오류.[TS4] Amount error
NTS_ERROR[TS5] 승인번호, 거래일자 중복 오류[TS5] Duplicated approval key and transaction date
NTS_ERROR[TS6] 거래일자 오류[TS6] Transaction date error
NTS_ERROR[TS7] 가맹점 사업자등록번호 미등록 오류 또는 현금영수증사업자의 승인코드가 불일치한 경우[TS7] The business number does not exist or does not match the business number on the cash receipt.
NTS_ERROR[TS8] Layout 오류(Record 항목별 입력 값 오류)[TS8] Layout error: Incorrect values for record fields
NTS_ERROR[TSC] 취소거래인 경우 원 승인거래 승인번호, 거래일자가 국세청에 미존재[TSC] The cancel transaction’s approval key and transaction date are not registered in the National Tax Service.
NTS_ERROR[TSD] 승인거래이면서 당초승인번호, 당초거래일자, 취소사유 입력[TSD] The cancel reason, original approval key, and original transaction date fields are given in an approval transaction.
NTS_ERROR[TSE] 취소거래와 승인거래의 가맹점 사업자등록번호 불일치[TSE] The business number of the cancel and approval transactions do not match.
NTS_ERROR[TSF] 취소거래와 승인거래의 거래자구분 불일치[TSF] The customer type of the cancel and approval transactions do not match.
NTS_ERROR[TSG] 취소거래와 승인거래의 거래금액 총합계 불일치[TSG] The amounts of the cancel and approval transactions do not add up to the total amount.
NTS_ERROR[TSH] 취소거래와 승인거래의 신분확인 불일치[TSH] The customer identity of the cancel and approval transactions do not match.
NTS_ERROR[TSN] 대중교통 및 도서·공연비 여부가 ‘C’이나, 해당 가맹점이 도서·공연비 사업자 명단에 없는 경우[TSN] The public transportation, book, performance ticket field value is ‘C’, but the business is not eligible for books and performance ticket tax deductions.
NTS_ERROR[TSO] 대중교통 및 도서·공연비 여부가 ‘Y’이나, 해당 가맹점이 도서·공연비 사업자 명단에 있는 경우[TSO] The public transportation, book, performance ticket field value is ‘Y’, but the business is eligible for books and performance ticket tax deductions.
NTS_ERROR[XXX] 정의 안된 오류[XXX] Undefined error

서브몰 등록

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ACCOUNT_OWNER_CHECK_FAILED계좌소유주 정보를 가져오는데 실패했습니다. `bank`와 `accountNumber` 값을 확인해주세요.Failed to get account holder. Please check `bank` and `accountNumber` parameter.
400INVALID_ACCOUNT_NUMBER계좌번호가 올바르지 않습니다.Invalid account number
400ALREADY_EXIST_SUBMALL이미 존재하는 서브몰입니다.Duplicated `submallId`
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.

서브몰 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.

서브몰 수정

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ACCOUNT_OWNER_CHECK_FAILED계좌소유주 정보를 가져오는데 실패했습니다. `bank`와 `accountNumber` 값을 확인해주세요.Failed to get account holder. Please check `bank` and `accountNumber` parameter.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400INVALID_ACCOUNT_NUMBER계좌번호가 올바르지 않습니다.Invalid account number
404NOT_FOUND존재하지 않는 정보 입니다.Not found information
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.

서브몰 삭제

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
404NOT_FOUND존재하지 않는 정보 입니다.Not found information

지급 가능한 잔액 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403INCORRECT_BASIC_AUTH_FORMAT잘못된 요청입니다. ':' 를 포함해 인코딩해주세요.Invalid request. Please encode including the ':' character.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.

지급대행 요청

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_PAYABLE_DATE지급일자가 올바르지 않습니다.The payment date is incorrect.
400NOT_ENOUGH_AMOUNT지급가능한 금액을 초과했습니다.Payout amount exceeded.
400DUPLICATED_REQUEST중복된 요청입니다.This is a duplicate request.
400NOT_ALLOWED_HOLIDAY공휴일은 지급일로 선택할 수 없습니다.Public holidays cannot be selected as payment dates.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.`amount` should be greater than 0.
404NOT_FOUND_SUBMALL존재하지 않는 서브몰입니다.Not found `submallId`
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.Not found payment
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.

지급대행 요청 취소

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400DUPLICATED_REQUEST중복된 요청입니다.This is a duplicate request.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
404PAYOUT_NOT_FOUND존재하지 않는 지급대행 입니다.The payout does not exist.

지급대행 단건 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
404PAYOUT_NOT_FOUND존재하지 않는 지급대행 입니다.The payout does not exist.

전체 에러 목록

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

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ACCOUNT_OWNER_CHECK_FAILED계좌 소유주를 가져오는데 실패했습니다. 은행코드, 계좌번호를 확인해주세요.Failed to get account holder. Please check your bank code and account number.
400ALREADY_CANCELED_PAYMENT이미 취소된 결제 입니다.The payment has already been canceled.
400ALREADY_CLOSE_ACCOUNT이미 해지된 계좌입니다.This account has already been closed.
400ALREADY_COMPLETED_PAYMENT이미 완료된 결제 입니다.This is a payment that has already been completed.
400ALREADY_EXIST_SUBMALL이미 존재하는 서브몰입니다.This sub-mall is already exists.
400ALREADY_PROCESSED_PAYMENT이미 처리된 결제 입니다.This is a payment that has already been processed.
400ALREADY_REFUND_PAYMENT이미 환불된 결제입니다.The payment has already been refunded.
400ALREADY_REFUNDING_PAYMENT이미 환불 중인 결제입니다.The payment is already being refunded.
400API_VERSION_UPDATE_NEEDED이 API를 사용하려면 [VERSION] 이상의 버전을 사용해야 합니다. 개발자센터(https://developers.tosspayments.com)에서 버전을 변경해주세요.To use the api need to upgrade version to [VERSION]. You can update api version at Tosspayment Developer Center(https://developers.tosspayments.com)
400BELOW_MINIMUM_AMOUNT신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.Payment can be made from 100 won or more by credit card, and 200 won or more for account.
400BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.The amount must be greater than 0.
400DUPLICATED_CASH_RECEIPT이미 현금영수증이 발급된 주문입니다.This is a duplicate request that has already been issued.
400DUPLICATED_ORDER_ID이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id.
400DUPLICATED_REQUEST중복된 요청입니다.This is a duplicate request.
400EXCEED_MAX_AMOUNT거래금액 한도를 초과했습니다.The transaction amount limit has been exceeded.
400EXCEED_MAX_CARD_INSTALLMENT_PLAN설정 가능한 최대 할부 개월 수를 초과했습니다.You have exceeded the maximum number of installment months that can be set.
400EXCEED_MAX_DAILY_PAYMENT_COUNT하루 결제 가능 횟수를 초과했습니다.You have exceeded the number of daily payments.
400EXCEED_MAX_DUE_DATE가상 계좌의 최대 유효만료 기간을 초과했습니다.You have exceeded the maximum expiry period for your virtual account.
400EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT1일 출금 한도를 초과했습니다.You have exceeded the one-day withdrawal limit.
400EXCEED_MAX_ONE_TIME_WITHDRAW_AMOUNT1회 출금 한도를 초과했습니다.You have exceeded the one-time withdrawal limit.
400EXCEED_MAX_PAYMENT_AMOUNT하루 결제 가능 금액을 초과했습니다.You have exceeded the amount you can pay per day.
400EXCEED_MAX_QUERY_LIMIT최대 조회 개수를 초과했습니다.You have exceeded the maximum number of query limit.
400EXCEED_MAX_VALID_HOURS가상 계좌의 최대 유효시간을 초과했습니다.The maximum validity time of the virtual account has been exceeded.
400EXCEED_MIN_CARD_INSTALLMENT_PLAN설정 가능한 최소 할부 개월 수를 1개월 이상으로 설정해주세요.The minimum installment month must be set to at least 1 month.
400EXCEED_UNKNOWN_CASE한도 초과 되었습니다.A threashold exceeds
400INCORRECT_FAIL_URL_FORMAT잘못된 failUrl 입니다.Invalid format: failUrl
400INCORRECT_SUCCESS_URL_FORMAT잘못된 successUrl 입니다.Invalid format: successUrl
400INVALID_ACCOUNT_NOT_CORRECT_BANK입력하신 계좌는 해당 은행의 계좌가 아닙니다.The account you entered is not a bank account.
400INVALID_ACCOUNT_NUMBER계좌번호가 올바르지 않습니다.Account number is incorrect.
400INVALID_ACCOUNT_NUMBER_OR_UNAVAILABLE잘못된 계좌번호이거나 서비스 불가한 계좌입니다.Wrong account number or account unavailable.
400INVALID_API_KEY잘못된 시크릿키 연동 정보 입니다.Incorrect secret key.
400INVALID_AUTHORIZE_AUTH잘못된 인증 방식입니다.Incorrect authentication.
400INVALID_AUTHORIZE_AUTH_TYPE_GIFT_CERTIFICATE유효하지 않은 상품권 결제 인증 타입입니다.This is an invalid gift certificate payment authentication type.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400INVALID_BILL_KEY_REQUEST빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다.Billing key authentication has not been completed or is an invalid billing transaction.
400INVALID_BILLING_AUTH유효하지 않은 빌링 인증입니다.Invalid billing authentication.
400INVALID_BIRTH_DAY_FORMAT생년월일 정보는 6자리의 yyMMdd 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다.The birth date format must be in 6 length of yyMMdd format.
400INVALID_BUSINESS_NUMBER사업자 등록번호가 잘못되었습니다.The business registration number is incorrect.
400INVALID_CARD카드 입력정보가 올바르지 않습니다.Card input information is incorrect.
400INVALID_CARD_COMPANY유효하지 않은 카드사입니다.It is an invalid card company.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요.(유효기간) Please check the card expiration date information again.
400INVALID_CARD_IDENTITY입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다.The entered resident registration number/business number does not match the cardholder information.
400INVALID_CARD_INSTALLMENT_AMOUNT할부금액 잘못 되었습니다.The installment amount is incorrect.
400INVALID_CARD_INSTALLMENT_PLANS_WITH_MAX_AND_SINGLEcardInstallmentPlan과 maxCardInstallmentPlan은 같이 사용할 수 없습니다.cardInstallmentPlan and maxCardInstallmentPlan cannot be used together.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_CARD_PASSWORD카드 정보를 다시 확인해주세요.(비밀번호) Please check the card information again.
400INVALID_CASH_RECEIPT_INFO현금 영수증 정보가 잘못되었습니다.Cash receipt information is incorrect.
400INVALID_CLIENT_KEY잘못된 클라이언트 연동 정보 입니다.Incorrect client key.
400INVALID_CURRENCY잘못된 통화 값입니다.Invalid currency value.
400INVALID_CUSTOMER_KEYcustomerKey는 영문 대소문자, 숫자, 특수문자 -, *, =, ., @로 2자 이상 255자 이하여야 합니다.customerKey must be at least 2 and maximum 20 upper and lower case alphabets, numbers, special characters (-, _, =, ., @).
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.
400INVALID_EASY_PAY간편결제 입력정보가 올바르지 않습니다.The easy payment input information is incorrect.
400INVALID_EMAIL이메일 주소 형식에 맞지 않습니다.It doesn't match the email address format.
400INVALID_FLOW_MODE_PARAMETERS인증 창을 먼저 띄우려면 카드사 코드 또는 은행 코드 또는 간편결제수단이 같이 전달되어야 합니다.If you want to open the payment authentication window first, the credit card company code, bank code, or easy payment method must be delivered together.
400INVALID_IDENTIFICATION_TYPE유효하지 않은 본인 인증 타입입니다.This is an invalid authentication type
400INVALID_ISO_DATE_FORMAT시간 일시 형식이 잘못되었습니다. 시간 형식은 ISO 8601 형식을 준수해야 합니다.The format is incorrect. The time format must conform to ISO 8601 format.
400INVALID_ORDER_IDorderId는 영문 대소문자, 숫자, 특수문자(-, _) 만 허용합니다. 6자 이상 64자 이하여야 합니다.The order id must be at least 6 and maximum 64 upper and lower case alphabets, numbers, special characters (-, _, =).
400INVALID_ORDER_NAME주문 이름은 100자 이하여야 합니다.The order name must be 100 characters or less.
400INVALID_PAGING_KEY잘못된 페이징 키 입니다.Bad paging key.
403INVALID_PASSWORD결제 비밀번호가 일치하지 않습니다.Payment password does not match.
400INVALID_PAYABLE_DATE지급일자가 올바르지 않습니다.The payment date is incorrect.
400INVALID_PAYMENT_KEY잘못된 결제 키 입니다.Invalid payment key.
400INVALID_REFUND_ACCOUNT_INFO환불 계좌번호와 예금주명이 일치하지 않습니다.Refund account number and account holder name do not match.
400INVALID_REFUND_ACCOUNT_NUMBER잘못된 환불 계좌번호입니다.Incorrect refund account number.
400INVALID_REFUND_AMOUNT잘못된 환불 금액입니다.Incorrect refund amount.
400INVALID_REJECT_CARD카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.Refer to card issuer/decline.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The installment amount is incorrect.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400INVALID_SUBMALL_ID유효하지 않은 서브몰 ID 입니다. 영문, 숫자 20글자 이하로 입력해주세요.This submall ID is not valid. Please enter 20 letters or less in alphabets or numbers.
400INVALID_SUCCESS_URLsuccessUrl 값은 필수 값입니다.The successUrl value is a required value.
400INVALID_TEST_CODE유효하지 않은 테스트 코드입니다.Invalid test code
400INVALID_UNREGISTERED_SUBMALL미등록된 PG 하위몰 이거나 단독가맹점은 안심클릭/ISP 결제가 필요합니다.The PG sub-merchant is not registered yet OR payment authentication method of the card issuer is required for the PG
400INVALID_URLurl 은 http, https 를 포함한 주소 형식이어야 합니다.url must be in address format including http and https.
400INVALID_URL_FORMAT잘못된 URL 형식입니다.Invalid URL format.
400INVALID_VALID_HOURS_WITH_DUE_DATE_AND_SINGLEvalidHours와 dueDate는 같이 사용할 수 없습니다.validHours and dueDate cannot be used together.
400INVALID_VIRTUAL_ACCOUNT_TYPE유효하지 않은 가상계좌 타입입니다.Invalid virtual account type.
400MAINTAINED_METHOD현재 점검 중 입니다.The method is being maintained now
400NOT_ALLOWED_HOLIDAY공휴일은 지급일로 선택할 수 없습니다.Public holidays cannot be selected as payment dates.
400NOT_ALLOWED_INSTALLMENT_BELOW_AMOUNT해당 카드는 10000원 미만 할부 거래가 불가한 카드입니다.This card cannot be used for installment transactions less than KRW 10000.
400NOT_ALLOWED_POINT_USE포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다.Card point payment failed because the card cannot be used points.
400NOT_ENOUGH_AMOUNT지급가능한 금액을 초과했습니다.The payable amount has been exceeded.
400NOT_FOUND_TERMINAL_ID단말기번호(Terminal Id)가 없습니다. 토스페이먼츠로 문의 바랍니다.There is no Terminal Id. Please contact Toss Payments.
400NOT_MATCH_PAYEE_NAME수취인 성명이 불일치 합니다.The payee's name is inconsistent.
400NOT_MATCHES_CUSTOMER_KEY빌링 인증 고객키와 결제 요청 고객키가 일치하지 않습니다.The billing authentication customer key and the payment request customer key do not match.
400NOT_MATCHES_REFUNDABLE_AMOUNT잔액 결과가 일치하지 않습니다.Balance results do not match.
400NOT_REGISTERED_BUSINESS등록되지 않은 사업자 번호입니다.Unregsitered business registration number
400NOT_REGISTERED_SUBMALLPG 하위몰 사업자번호가 등록되어 있지 않습니다.PG sub-mall business number is not registered.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
400NOT_SUPPORTED_CARRIER지원되지 않는 이동 통신사입니다.Unsupported carrier.
400NOT_SUPPORTED_METHOD지원되지 않는 결제수단입니다.This payment method is not supported.
400NOT_SUPPORTED_METHOD지원되지 않는 결제수단입니다.This payment method is not supported.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부 또는 무이자 할부가 지원되지 않는 카드입니다.This card does not support installment or interest-free installment.
400NOT_SUPPORTED_PROCESS지원되지 않는 작업입니다.This operation is not supported.
400NOT_SUPPORTED_USD선택하신 카드 또는 결제수단은 달러 결제가 불가합니다.The selected card or payment method cannot be paid in dollars.
400PAY_PROCESS_ABORTED결제가 취소되었거나 진행되지 않았습니다.Payment has been canceled or has not been processed.
400PAY_PROCESS_CANCELED결제가 사용자에 의해 취소되었습니다.Payment has been canceled by the customer.
400REFUND_REJECTED환불이 거절됐습니다. 결제사에 문의 부탁드립니다.The refund has been rejected. Please contact the respective payment provider.
400REQUIRED_ACCOUNT_KEY고정계좌는 발급용 고객키 값이 필수입니다.For fixed accounts, a customer key value is required.
400REQUIRED_AMOUNT금액 값이 필수입니다.Amount value is required.
400USER_ACCOUNT_ON_HOLD계정이 사용 불가능한 상태입니다.Account is on hold.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.This is an unauthenticated secret key or client key.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.The maximum number of authentications has been exceeded. Please contact your credit card company.
403EXCEED_MAX_REFUND_AMOUNT하루 또는 한달 환불 가능한 금액을 초과했습니다.This merchant have exceeded your daily or monthly refundable amount.
403EXCEED_MAX_REFUND_DUE환불 가능한 기간이 초과했습니다.The refundable period has been exceeded.
403FORBIDDEN_CONSECUTIVE_REQUEST반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요.Repetitive requests are not allowed. Please try again in a few minutes.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.This request is not allowed.
403NOT_ALLOWED_CHANGING_ACCOUNT이미 입금, 반납된 계좌의 정보 변경은 불가합니다.It is not possible to change the information of the account that has already been deposited or returned.
403NOT_ALLOWED_PARTIAL_REFUND에스크로 주문, 현금 카드 결제 등의 사유로 부분 환불이 불가합니다.Partial refunds are not available for reasons such as escrow or cash payment.
403NOT_ALLOWED_PARTIAL_REFUND_WAITING_DEPOSIT입금 대기중인 결제는 부분 환불이 불가합니다.Partial refunds are not available while pending deposit.
403NOT_ALLOWED_REFUND_BANK환불 가능한 은행이 아닙니다.Not a refundable bank.
403NOT_AVAILABLE_BANK은행 서비스 시간이 아닙니다.Not bank service time.
403NOT_CANCELABLE_AMOUNT취소 할 수 없는 금액 입니다.This is a non-cancelable amount.
403NOT_CANCELABLE_PAYMENT취소 할 수 없는 결제 입니다.This is a non-cancelable payment.
403NOT_SUPPORTED_REFUND환불 가능한 상점이 아닙니다.Not a refundable merchant.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment failed due to insufficient balance
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment confirm is rejected
404NOT_FOUND존재하지 않는 정보 입니다.This information does not exist.
404NOT_FOUND_BILLING존재하지 않는 빌링 결제 인증 정보 입니다.Billing payment authentication information that does not exist.
404NOT_FOUND_HTTP_METHOD존재하지 않는 HTTP 메소드 접근입니다.This HTTP method does not allowed.
404NOT_FOUND_MERCHANT존재하지 않는 상점 정보 입니다.The merchant does not exist.
404NOT_FOUND_MERCHANT_INTEGRATION존재하지 않는 상점 연동 정보 입니다.The integration information does not exist.
404NOT_FOUND_METHOD존재하지 않는 결제수단 입니다.This payment method does not exist.
404NOT_FOUND_METHOD_IN_GROUP같은 그룹내에 존재하지 않는 결제수단 입니다.This payment method does not exist in the same group
404NOT_FOUND_METHOD_OWNERSHIP결제수단의 소유자가 아닙니다.This method ownership is not correct.
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.The payment does not exist.
404NOT_FOUND_PAYMENT_SESSION결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다.Payment session does not exist because the session time has expired.
404NOT_FOUND_SUBMALL존재하지 않는 서브몰입니다.This sub-mall does not exist.
404PAYOUT_NOT_FOUND존재하지 않는 지급대행 입니다.The payout does not exist.
500FAILED_BILL_KEY_AUTH_CREATION빌링 결제 인증 중 키 생성에 실패했습니다. 잠시 후 다시 시도해주세요.Key generation failed during billing payment verification. Please try again in a few minutes.
500FAILED_BILLING_AUTO_CANCEL빌링 자동결제 취소에 일시적인 오류가 발생했습니다.A temporary error occurred while billing auth cancellation.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.A DB error occurred while processing with an invalid request value.
500FAILED_HASH_DATA_CREATION해시 데이터 생성 중 오류가 발생했습니다.An error occurred while generating hash data.
500FAILED_INTERNAL_SYSTEM_PROCESSING내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요.Internal system processing operation has failed. Please try again in a few minutes.
500FAILED_METHOD_HANDLING결제 중 선택한 결제수단 처리에 일시적인 오류가 발생했습니다.There was a temporary error in processing the payment method you selected during checkout.
500FAILED_METHOD_HANDLING_CANCEL취소 중 결제 시 사용한 결제수단 처리과정에서 일시적인 오류가 발생했습니다.A temporary error occurred while processing cancellation.
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제 기관(카드사, 은행, 국세청 등) 오류입니다. 결제 기관에서 보내 준 에러 메시지가 표시됩니다.Provider error. The error message received from provider will be displayed.
500FAILED_REFUND_PROCESS은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다.The refund request failed due to a delay in the bank response time or a temporary error.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.A temporary error has occurred. Please try again in a few minutes.
500UNKNOWN_ERROR확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요.An unknown error occurred. Please try again in a few minutes.

브랜드페이 API 별 에러

미동의 약관 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The required parameter is missing.
400NOT_SUPPORTED_TERM_SCOPE가능한 약관 조합이 아닙니다.The term scope combination is not valid

약관 동의

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400REQUIRED_TERMS필수 약관에 모두 동의해주세요.Please agree to all required terms
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The required parameter is missing.
400NOT_SUPPORTED_TERM_SCOPE가능한 약관 조합이 아닙니다.The term scope combination is not valid

Access Token 발급

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_PHONE전화번호 형식에 맞지 않습니다. 전화번호에는 특수문자가 포함될 수 없습니다.It doesn't fit the phone number format. Phone numbers cannot contain special characters.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400ALREADY_REGISTERED_CUSTOMER_CI이미 가입된 정보입니다.This information has already been signed up.
400NOT_SUPPORTED_AGE만 14세 이상 고객만 이용 가능합니다.Only available to customers over the age of 14.
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.Not allowed request
403FORBIDDEN_CONSECUTIVE_REQUEST반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요.Repetitive requests are not allowed. Please try again in a few minutes.
403NOT_UPDATE_AUTHORIZATION_CODE인증코드를 갱신하지 않았습니다.You do not update authorization code.
403EXPIRED_AUTHORIZATION_CODE만료된 인증코드 값입니다.The authorization code had been expired.
403NOT_MATCHES_ENROLLED_CUSTOMER_KEY등록된 고객키와 accessToken 요청 고객키가 일치하지 않습니다.The enrolled customer key and the accessToken request customer key do not match.
403REQUIRED_DORMANT_VERIFICATION장기간 서비스 미사용으로 인한 휴면 상태로 계정이 잠겼습니다. 본인 인증으로 휴면 해제 후 다시 시도해주세요.Account has been dormant due to long-term non-use of service. Please verify your identity and try again.
404NOT_FOUND_CUSTOMER유효한 고객 정보가 없습니다.There is no valid customer information.
404NOT_FOUND_CUSTOMER_SESSION고객 세션을 찾을 수 없습니다.No customer sessions were found.
404NOT_FOUND_AUTHORIZATION_CODE인증코드 값을 찾을 수 없습니다.The authorization code value could not be found.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.A DB error occurred while processing with an invalid request value.

SecretKey로 결제수단 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
404NOT_FOUND_CUSTOMER유효한 고객 정보가 없습니다.There is no valid customer information.

카드 결제수단 삭제

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.Not found payment method
404NOT_FOUND_PAYMENT_METHOD존재하지 않는 결제 수단 입니다.This payment method does not exist.
404NOT_FOUND_CUSTOMER_SESSION고객 세션을 찾을 수 없습니다.No customer sessions were found.
500FAILED_CARD_COMPANY카드사 점검 중으로 다른 카드를 이용해 주세요.Please use another card while checking the credit card company system.
500UNKNOWN_ERROR확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요.An unknown error occurred. Please try again in a few minutes.

계좌 결제수단 삭제

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400MAINTAINED_METHOD현재 점검 중 입니다.Under maintenance.
400INVALID_REQUEST잘못된 요청입니다.The bad request.

결제 승인

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_CARD_INSTALLMENT_PLAN할부 개월 정보가 잘못되었습니다.The installment month information is incorrect.
400INVALID_UNREGISTERED_SUBMALL등록되지 않은 서브몰입니다. 서브몰이 없는 가맹점이라면 안심클릭이나 ISP 결제가 필요합니다.Not registered PG sub-mall business number.
400EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT1일 출금 한도를 초과했습니다.You have exceeded the one-day withdrawal limit.
400INVALID_API_KEY잘못된 시크릿키 연동 정보 입니다.Incorrect secret key.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.Not allowed request
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment declined due to insufficient balance.
403REJECT_CARD_PAYMENT한도초과 혹은 잔액부족으로 결제에 실패했습니다.Payment failed due to limit exceeded or insufficient balance.
403EXCEED_MAX_ONE_DAY_AMOUNT일일 한도를 초과했습니다.You have exceeded your daily limit.
403SUSPECTED_PHISHING_PAYMENT결제에 실패했습니다. 피싱사고 의심 거래입니다.Payment rejected due to suspected phishing scam.
404NOT_FOUND_PAYMENT_SESSION결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다.Payment session does not exist because the session time has expired.
500FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING결제가 완료되지 않았어요. 다시 시도해주세요.Payment has not been completed. please try again.
500FAILED_OPEN_BANKING_PROCESSING오픈뱅킹 통신 장애입니다. 잠시 후 다시 시도해주세요.The open banking communication failure. Please try again in a few minutes.

자동결제 실행

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400BELOW_MINIMUM_AMOUNT신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다.Payment can be made from 100 won or more by credit card, and 200 won or more for account.
400DUPLICATED_ORDER_ID이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요.This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id.
400EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT1일 출금 한도를 초과했습니다.You have exceeded the one-day withdrawal limit.
400INVALID_ACCOUNT_INFO_RE_REGISTER유효하지 않은 계좌입니다. 계좌 재등록 후 시도해주세요.Invalid account. Please re-register the account and try again.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요. (유효기간)Please check the card expiration date information again.
400INVALID_CARD_INFO_RE_REGISTER유효하지 않은 카드입니다. 카드 재등록 후 시도해주세요.Invalid card. Please re-register the card and try again.
400INVALID_CARD_INSTALLMENT_AMOUNT할부금액 잘못 되었습니다.The installment amount is incorrect.
400INVALID_CARD_LOST_OR_STOLEN분실 혹은 도난 카드입니다.This is a lost or stolen card
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_REJECT_CARD카드 사용이 거절되었습니다. 카드사 문의가 필요합니다.Refer to card issuer/decline.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_STOPPED_ACCOUNT정지된 계좌 입니다.This is a suspended account.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400MAINTAINED_METHOD현재 점검 중 입니다.Under maintenance.
400NOT_SUPPORTED_METHOD지원되지 않는 결제 수단입니다.This payment method is not supported.
400PROVIDER_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.This is temporary error. Please try again in a few minutes.
400RESTRICTED_TRANSFER_ACCOUNT계좌는 등록 후 12시간 뒤부터 결제할 수 있습니다. 관련 정책은 해당 은행으로 문의해주세요.You can withdraw from this bank account after 12 hours from initial register. For related policies, please contact your bank.
400INVALID_REQUIRED_PARAM필수 파라미터가 누락되었습니다.The required parameter is missing.
400NOT_SUPPORTED_BILLING_MERCHANT자동 결제를 등록한 상점이 아닙니다. 자동 결제 사용을 활성화해주세요.This merchant is not registered to use billing payments.
400REQUIRED_BILLING_TERMS자동 결제 이용약관에 동의해야 합니다.Please agree to billing terms.
403EXCEED_MAX_ONE_DAY_AMOUNT일일 한도를 초과했습니다.You have exceeded your daily limit.
403FAILED_PAYMENT_CONFIRM결제 승인이 실패하였습니다.Payment approval failed.
403FORBIDDEN_DORMANT_OR_WITHDRAWAL_CUSTOMER휴면고객이거나 탈퇴한 고객입니다.You are a dormant customer or a member who has been withdrawn.
403INVALID_PASSWORD결제 비밀번호가 일치하지 않습니다.Incorrect password
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment declined due to insufficient balance.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment confirm is rejected
403REJECT_CARD_PAYMENT한도초과 혹은 잔액부족으로 결제에 실패했습니다.Payment failed due to limit exceeded or insufficient balance.
403SUSPECTED_PHISHING_PAYMENT결제에 실패했습니다. 피싱사고 의심 거래입니다.Payment rejected due to suspected phishing scam.
404NOT_FOUND_CUSTOMER유효한 고객 정보가 없습니다.There is no valid customer information.
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.Not found payment method
404NOT_FOUND_METHOD_OWNERSHIP결제수단의 소유자가 아닙니다.Not found method ownership
500FAILED_CARD_COMPANY카드사 점검 중으로 다른 카드를 이용해 주세요.Please use another card while checking the credit card company system.
500FAILED_DB_PROCESSING잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다.A DB error occurred while processing with an invalid request value.
500FAILED_SYSTEM_CHECK_TIME해당 은행 시스템 점검 시간입니다. 잠시 후 다시 시도해 주세요.It is time to check the system. Please try again in a few minutes.
500UNKNOWN_PAYMENT_ERROR결제에 실패했어요. 같은 문제가 반복된다면 은행이나 카드사로 문의해주세요.Payment failed. If the same problem occurs, please contact your bank or credit card company.

회원 탈퇴 처리

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_ACCESS_TOKEN유효하지 않은 `accessToken` 입니다.Invalid `accessToken`.
403EXPIRED_TOKEN만료된 토큰 값입니다.The token had been expired.
404NOT_FOUND_CUSTOMER유효한 고객 정보가 없습니다.There is no valid customer information.
500UNKNOWN_ERROR확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요.An unknown error occurred. Please try again in a few minutes.

카드 프로모션 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
401UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.Unauthorized secretKey or clientKey.

계좌 프로모션 조회

상태 코드에러 코드한글 에러 메시지영문 에러 메시지
404NOT_FOUND_MERCHANT존재하지 않는 상점 정보 입니다.Not found merchant id

구 모듈 에러

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

구 모듈 에러

  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기