에러 코드

브라우저 에러 코드

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

에러 코드한글 메시지영문 메시지
PAY_PROCESS_CANCELED사용자에 의해 결제가 취소되었습니다.Payment has been canceled by the customer.
PAY_PROCESS_ABORTED결제 진행 중 승인에 실패하여 결제가 중단되었습니다.Payment has been canceled or has not been processed.
REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment was rejected.

일반 결제 API별 에러 코드

결제 승인 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400EXCEED_MAX_CARD_INSTALLMENT_PLAN설정 가능한 최대 할부 개월 수를 초과했습니다.You have exceeded the maximum number of installment months that can be set.
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.
400INVALID_ACCOUNT_NUMBER_OR_UNAVAILABLE잘못된 계좌번호이거나 서비스 불가한 계좌입니다.Wrong account number or account unavailable.
400INVALID_AUTHORIZE_AUTH잘못된 인증 방식입니다.Incorrect authentication.
400INVALID_CARD_IDENTITY입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다.The entered resident registration number/business number does not match the cardholder information.
400INVALID_OTPOTP 번호가 잘못되었거나 타기관 응답 오류 입니다.The OTP number is incorrect or there is a third party response error.
400NOT_FOUND_TERMINAL_ID단말기번호(Terminal Id)가 없습니다. 토스페이먼츠로 문의 바랍니다.There is no Terminal Id. Please contact Toss Payments.
400NOT_REGISTERED_BUSINESS미등록된 사업자 입니다.It is an unregistered business.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부 또는 무이자 할부가 지원되지 않는 카드입니다.This card does not support installment or interest-free installment.

결제 조회 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
403FORBIDDEN_CONSECUTIVE_REQUEST반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요.Repetitive requests are not allowed. Please try again in a few minutes.
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.This payment method does not exist.

결제 취소 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ALREADY_CANCELED_PAYMENT이미 취소된 결제 입니다.The payment has already been canceled.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400INVALID_REFUND_ACCOUNT_INFO환불 계좌번호와 예금주명이 일치하지 않습니다.Refund account number and account holder name do not match.
400INVALID_REFUND_ACCOUNT_NUMBER잘못된 환불 계좌번호입니다.Incorrect refund account number.
400NOT_MATCHES_REFUNDABLE_AMOUNT잔액 결과가 일치하지 않습니다.Balance results do not match.
403EXCEED_MAX_REFUND_DUE환불 가능한 기간이 초과했습니다.The refundable period has been exceeded.
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.This request is not allowed.
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_CANCELABLE_AMOUNT취소 할 수 없는 금액 입니다.This is a non-cancelable payment.
403NOT_CANCELABLE_PAYMENT취소 할 수 없는 결제 입니다.This is a non-cancelable amount.
404INVALID_REFUND_AMOUNT잘못된 환불 금액입니다.Incorrect refund amount.
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.This payment method does not exist.
404NOT_FOUND_PAYMENT존재하지 않는 결제 정보 입니다.The payment does not exist.
500FAILED_METHOD_HANDLING_CANCEL취소 중 결제 시 사용한 결제 수단 처리과정에서 일시적인 오류가 발생했습니다. Atemporary error occurred while processing cancellation.
500FAILED_REFUND_PROCESS은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다.The refund request failed due to a delay in the bank response time or a temporary error.

카드 정보 결제 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
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_BIRTH_DAY_FORMAT생년월일 정보는 6자리의 yyMMdd 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다.The birth date format must be in 6 length of yyMMdd format.
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_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_CARD_PASSWORD카드 정보를 다시 확인해주세요.(비밀번호)Please check the card information again.
400INVALID_EMAIL이메일 주소 형식에 맞지 않습니다.It doesn't match the email address format.
400INVALID_ORDER_ID주문번호는 영문 대소문자, 숫자, 특수문자 -, _, =로 6자 이상 64자 이하여야 합니다.The order id must be at least 6 and maximum 64 upper and lower case alphabets, numbers, special characters (-, _, =).
400INVALID_REJECT_CARD카드사에 문의 바랍니다.Refer to card issuer/decline.
400INVALID_REQUEST잘못된 요청입니다.The bad request.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
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 main merchant.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
400NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN할부 또는 무이자 할부가 지원되지 않는 카드입니다.This card does not support installment or interest-free installment.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.The maximum number of authentications has been exceeded. Please contact your credit card company.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment failed due to insufficient balance.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment was rejected.

가상계좌 발급 요청 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400EXCEED_MAX_DUE_DATE가상 계좌의 최대 유효만료 기간을 초과했습니다.You have exceeded the maximum expiry period for your virtual account.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400REQUIRED_ACCOUNT_KEY고정계좌는 발급용 고객키 값이 필수입니다.For fixed accounts, a customer key value is required.

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

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_BILL_KEY_REQUEST빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다.Billing key authentication has not been completed or is an invalid billing transaction.
400INVALID_BIRTH_DAY_FORMAT생년월일 정보는 6자리의 yyMMdd 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다.The birth date format must be in 6 length of yyMMdd format.
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_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_CARD_PASSWORD카드 정보를 다시 확인해주세요.(비밀번호)Please check the card information again.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
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 main merchant.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.The maximum number of authentications has been exceeded. Please contact your credit card company.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment was rejected.

카드 자동 결제 승인 요청 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
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_BILL_KEY_REQUEST빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다.Billing key authentication has not been completed or is an invalid billing transaction.
400INVALID_CARD_EXPIRATION카드 정보를 다시 확인해주세요. (유효기간)Please check the card expiration date information again.
400INVALID_CARD_NUMBER카드번호를 다시 확인해주세요.Please check your card number again.
400INVALID_REJECT_CARD카드사에 문의 바랍니다.Refer to card issuer/decline.
400INVALID_STOPPED_CARD정지된 카드 입니다.This is a suspended card.
400NOT_MATCHES_CUSTOMER_KEY빌링 인증 고객키와 결제 요청 고객키가 일치하지 않습니다.The billing authentication customer key and the payment request customer key do not match.
400NOT_SUPPORTED_CARD_TYPE지원되지 않는 카드 종류입니다.This card type is not supported.
403EXCEED_MAX_AUTH_COUNT최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요.The maximum number of authentications has been exceeded. Please contact your credit card company.
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 main merchant.
403REJECT_ACCOUNT_PAYMENT잔액부족으로 결제에 실패했습니다.Payment failed due to insufficient balance.
403REJECT_CARD_COMPANY결제 승인이 거절되었습니다.Payment was rejected.

거래 조회 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400EXCEED_MAX_QUERY_LIMIT최대 조회 개수를 초과했습니다.You have exceeded the maximum number of query limit.
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.
400INVALID_TRANSACTION_KEY잘못된 페이징 키 입니다.Bad paging key.

정산 조회 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_DATE날짜 데이터가 잘못 되었습니다.The date data is invalid.

수동 정산 요청 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
403FORBIDDEN_REQUEST허용되지 않은 요청입니다.This request is not allowed.
404NOT_FOUND존재하지 않는 정보 입니다.This information does not exist.
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.This payment method does not exist.

현금영수증 발급 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400INVALID_BUSINESS_NUMBER사업자 등록번호가 잘못되었습니다.The business registration number is incorrect.
404NOT_FOUND존재하지 않는 정보 입니다.This information does not exist.
404NOT_FOUND_METHOD존재하지 않는 결제 수단 입니다.This payment method does not exist.

현금영수증 취소 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
404NOT_FOUND_RECEIPT존재하지 않는 현금영수증 정보 입니다.Cash receipt information does not exist.

서브몰 등록 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400ALREADY_EXIST_SUBMALL이미 존재하는 서브몰입니다.This sub-mall is already exists.
400INVALID_ACCOUNT_NUMBER계좌번호가 올바르지 않습니다.Account number is incorrect.
400INVALID_BANK유효하지 않은 은행입니다.It is an Invalid bank.
400INVALID_REQUEST잘못된 요청입니다.The bad request.

지급대행 요청 API

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
400BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.The amount must be greater than 0.
400DUPLICATED_REQUEST중복된 요청입니다.This is a duplicate request.
400INVALID_PAYABLE_DATE지급일자가 올바르지 않습니다.The payment date is incorrect.
400NOT_ALLOWED_HOLIDAY공휴일은 지급일로 선택할 수 없습니다.Public holidays cannot be selected as payment dates.

전체 에러 코드 목록

일반 결제 API에서 발생할 수 있는 전체 에러 목록입니다.

HTTP 상태 코드에러 코드한글 에러 메시지영문 에러 메시지
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.
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_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_FORMATfailUrl 은 http, https 를 포함한 주소 형식이어야 합니다.failUrl must be in address format including http and https.
400INCORRECT_SUCCESS_URL_FORMATsuccessUrl 은 http, https 를 포함한 주소 형식이어야 합니다.successUrl must be in address format including http and https.
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_KEY고객키는 영문 대소문자, 숫자, 특수문자 -, *, =, ., @로 2자 이상 255자 이하여야 합니다.The customer key 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_ID주문번호는 영문 대소문자, 숫자, 특수문자 -, *, =로 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.
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_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_UNREGISTERED_SUBMALL미등록된 PG 하위몰 이거나 단독가맹점은 안심클릭/ISP 결제가 필요합니다.The PG sub-merchant is not registered yet OR payment authentication method of the card issuer is required for the PGmain merchant.
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_ALLOWED_SKIP_AUTH운영 환경에서는 skipAuth 플래그 사용이 불가능합니다.The skipAuth flag cannot be used in production environments.
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미등록된 사업자 입니다.It is an unregistered business.
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.
400INVALID_TEST_CODE유효하지 않은 테스트 코드입니다.Invalid test code
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.
403INVALID_PASSWORD결제 비밀번호가 일치하지 않습니다.Payment password does not match.
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 was rejected.
403UNAUTHORIZED_KEY인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다.This is an unauthenticated secret key or client key.
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.
500COMMON_ERROR일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요.A temporary error has occurred. Please try again in a few minutes.
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_REFUND_PROCESS은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다.The refund request failed due to a delay in the bank response time or a temporary error.
500UNKNOWN_ERROR확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요.An unknown error occurred. Please try again in a few minutes.

구 모듈 에러 코드

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

구 모듈 에러 코드

내용이 도움 되셨나요?
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    디스코드 채팅|이메일 보내기