목차
에러 코드
토스페이먼츠 API/SDK를 사용할 때 발생할 수 있는 에러를 살펴보세요.
요청이 정상적으로 처리되지 않으면 응답으로 HTTP 상태 코드와 함께 아래와 같은 에러 객체가 돌아옵니다.
JSON
{
"code": "NOT_FOUND_PAYMENT",
"message": "존재하지 않는 결제 입니다."
}
code: 에러 타입을 보여주는 에러 코드입니다.message: 에러 메시지입니다. 에러 발생 이유를 알려줍니다.
이미 일어난 결제 기록을 조회했을 때는 Payment 객체의 failure필드에 에러 객체가 들어있습니다.
JSON
{
"mId": "tosspayments",
"version": "2022-11-16",
"lastTransactionKey": "B7103F204998813B889C77C043D09502",
"paymentKey": "5zJ4xY7m0kODnyRpQWGrN2xqGlNvLrKwv1M9ENjbeoPaZdL6",
"orderId": "a4CWyWY5m89PNh7xJwhk1",
"orderName": "토스 티셔츠 외 2건",
"currency": "KRW",
"method": "카드",
"status": "ABORTED",
// ...
"discount": null,
"cancels": null,
"secret": null,
"type": "NORMAL",
"easyPay": null,
"country": "KR",
"failure": {
"code": "COMMON_ERROR",
"message": "일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요."
},
"totalAmount": 15000,
"balanceAmount": 15000,
"suppliedAmount": 13636,
"vat": 1364,
"taxFreeAmount": 0,
"taxExemptionAmount": 0
}
SDK 에러
결제위젯 SDK, 브랜드페이 SDK, 결제창 SDK를 사용할 때 발생할 수 있는 에러를 안내합니다. 에러 응답을 처리하는 방법도 살펴보세요.
failUrl로 전달되는 에러
requestPayment() 메서드로 결제 요청에 실패했을 때 failUrl로 전달되는 에러 목록입니다. failUrl 설명은 결제위젯 JavaScript SDK 문서를 참고하세요.
| 에러 코드 | 한글 메시지 | 영문 메시지 |
|---|---|---|
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. |
결제(공통) SDK 에러
결제위젯 SDK, 브랜드페이 SDK, 결제창 SDK에서 제공하는 메서드 실행에 실패했을 때 발생하는 에러 목록입니다.
| 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|
BELOW_ZERO_AMOUNT | 금액은 0보다 커야 합니다. | The amount must be greater than 0. |
DUPLICATED_ORDER_ID | 이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요. | This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id. |
EXCEED_MAX_DUE_DATE | 가상 계좌의 최대 유효만료 기간을 초과했습니다. | You have exceeded the maximum expiry period for your virtual account. |
EXCEED_MAX_VALID_HOURS | 가상 계좌의 최대 유효시간을 초과했습니다. | The maximum validity time of the virtual account has been exceeded. |
FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | This request is not allowed. |
INCORRECT_FAIL_URL_FORMAT | 잘못된 failUrl 입니다. | Invalid format: failUrl |
INCORRECT_SUCCESS_URL_FORMAT | 잘못된 successUrl 입니다. | Invalid format: successUrl |
INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
INVALID_CARD_COMPANY | 유효하지 않은 카드사입니다. | It is an invalid card company. |
INVALID_CARD_INSTALLMENT_PLANS_WITH_MAX_AND_SINGLE | cardInstallmentPlan과 maxCardInstallmentPlan은 같이 사용할 수 없습니다. | cardInstallmentPlan and maxCardInstallmentPlan cannot be used together. |
INVALID_CUSTOMER_KEY | 고객키는 영문 대소문자, 숫자, 특수문자 -, _, =, ., @로 2자 이상 255자 이하여야 합니다. | The customer key must be at least 2 and maximum 255 upper and lower case alphabets, numbers, special characters (-, _, =, ., @). |
INVALID_DATE | 날짜 데이터가 잘못 되었습니다. | The date data is invalid. |
INVALID_EASY_PAY | 간편결제 입력정보가 올바르지 않습니다. | The easy payment input information is incorrect. |
INVALID_EMAIL | 이메일 주소 형식에 맞지 않습니다. | It doesn't match the email address format. |
INVALID_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. |
INVALID_MINOR_UNIT_FOR_CURRENCY | 금액의 소수점 자릿수를 통화 기준에 맞춰주세요. | The number of minor units needs to be in accordance with the currency standard. |
INVALID_ORDER_ID | orderId는 영문 대소문자, 숫자, 특수문자(-, _) 만 허용합니다. 6자 이상 64자 이하여야 합니다. | orderId must be at least 6 and maximum 64 characters including upper and lower case alphabets, numbers, special characters (-, _). |
INVALID_ORDER_NAME | 주문 이름은 100자 이하여야 합니다. | The order name must be 100 characters or less. |
INVALID_PARAMETER | 모바일 화면에서는 Promise 방식을 지원하지 않습니다. | - |
INVALID_PARAMETER | 'windowTarget="self"'는 Promise 방식을 지원하지 않습니다. | - |
INVALID_PARAMETER | "successUrl" 또는 "failUrl"을 넘긴 경우 Promise 방식을 지원하지 않습니다. | - |
INVALID_PHONE | 전화번호 형식에 맞지 않습니다. 전화번호에는 특수문자가 포함될 수 없습니다. | It doesn't fit the phone number format. Phone numbers cannot contain special characters. |
INVALID_SUCCESS_URL | successUrl 값은 필수 값입니다. | The successUrl value is a required value. |
INVALID_URL | url 은 http, https 를 포함한 주소 형식이어야 합니다. | url must be in address format including http and https. |
INVALID_VALID_HOURS_WITH_DUE_DATE_AND_SINGLE | validHours와 dueDate는 같이 사용할 수 없습니다. | validHours and dueDate cannot be used together. |
PAY_PROCESS_CANCELED | 결제가 사용자에 의해 취소되었습니다. | Payment has been canceled by the customer |
USER_CANCEL | 취소되었습니다 | - |
REJECT_PAYMENT_METHOD | 결제를 완료할 수 없습니다. PayPal 고객센터로 문의해주세요. | Payment failed. Contact PayPal customer service. |
REQUIRED_POSTAL_CODE | 우편번호가 필요한 국가입니다. | The specified country requires a postal code. |
INSUFFICIENT_PRIVILEGES | 요청에 대한 권한이 불충분합니다. 토스페이먼츠에 문의해주세요. | Insufficient privileges for requested resource. |
결제위젯 SDK 에러
결제위젯 SDK 메서드 실행에 실패했을 때 발생하는 에러 목록입니다.
| 에러 코드 | 에러 메시지 | 설명 |
|---|---|---|
INVALID_AMOUNT_VALUE | 결제금액이 올바르지 않습니다. | renderPaymentMethods() 또는 updateAmount()에 넘긴 결제금액 값이 숫자가 아니면 발생합니다. |
INVALID_CURRENCY | 잘못된 통화 값입니다. | renderPaymentMethods()에서 지원하지 않는 통화를 사용하면 발생합니다. 현재는 KRW, USD만 지원합니다. |
INVALID_SELECTOR | selector에 해당하는 HTML 요소를 찾을 수 없습니다. selector 값을 다시 확인해주세요. | renderPaymentMethods()를 실행했을 때 CSS 선택자를 찾을 수 없을 때 발생합니다. |
NEED_AGREEMENT_WITH_REQUIRED_TERMS | 필수 약관에 동의해주세요. | requestPayment()를 실행했을 때 모든 필수 약관에 동의 되어있지 않으면 발생합니다. |
NEED_CARD_PAYMENT_DETAIL | 카드 결제 정보를 선택해주세요. | 신용・체크카드 결제에서 카드사 또는 할부기간을 선택하지 않은 상태로 requestPayment()를 호출하면 발생합니다. |
NEED_REFUND_ACCOUNT_DETAIL | 환불 계좌 정보를 모두 입력해주세요. | 가상계좌 결제에서 환불 계좌 정보(은행, 예금주, 계좌번호)를 하나라도 입력하지 않은 상태로 requestPayment()를 호출하면 발생합니다. |
EXCEED_DEPOSIT_AMOUNT_LIMIT | 가상계좌 입금 제한 금액을 초과했어요. 다른 결제수단을 이용해주세요. | 가상계좌 결제에서 requestPayment()를 실행했을 때 입금할 수 있는 금액보다 amount 값이 크면 발생합니다. |
PROVIDER_STATUS_UNHEALTHY | 결제 기관(카드사, 은행, 국세청 등) 오류입니다. 다른 결제수단을 선택해 주세요. | 결제 기관의 시스템에 문제가 있을 때 발생합니다. 정확한 원인은 결제 기관에 문의해주세요. |
브랜드페이 SDK 에러
브랜드페이 SDK 메서드 실행에 실패했을 때 발생하는 에러 목록입니다.
| 에러 코드 | 에러 메시지 | 설명 |
|---|---|---|
USER_CANCEL | 취소되었습니다. | 사용자가 브랜드페이 창을 닫았을 때 발생하는 에러입니다. 브랜드페이 창을 여는 모든 메서드에서 발생할 수 있습니다. |
NEED_AGREEMENT_WITH_TERMS | 이용약관 동의가 필요합니다. | 사용자의 데이터를 SDK로 가져오지 못했을 때 발생합니다. 사용자가 약관 동의 과정을 마치고 브랜드페이 서비스에 가입되어 있어야 합니다. |
INVALID_TERMS | 유효하지 않은 약관이 사용되었습니다: {약관 내용} | requestAgreement()의 파라미터로 넘긴 약관이 지원되지 않는 타입일 때 발생합니다. 올바른 약관 타입인지 확인해주세요. |
AUTH_REQUEST_MAXIMUM_CALL_EXCEEDED | 최대 요청횟수를 초과했습니다. | SDK 내부에서 사용하는 사용자의 Customer Token에 대한 최대 요청 횟수(300회)를 넘겼을 때 발생합니다. Customer Token이 필요한 모든 메서드에서 발생할 수 있습니다. |
AUTH_REQUEST_FAILED | 토큰을 획득하는데 실패했습니다. | 사용자의 Customer Token 요청에 실패했을 때 발생하는 에러입니다. Customer Token이 필요한 모든 메서드에서 발생할 수 있습니다. |
NOT_EXISTED_PAYMENT_METHOD | 결제수단이 존재하지 않습니다. 결제수단을 먼저 등록해주세요. | requestPayment()의 파라미터로 넘긴 methodId가 유효하지 않을 때 발생하는 에러입니다. |
NEED_MERCHANT_ONE_TOUCH_SETTING | 원터치결제 사용을 위해서는 가맹점 설정이 필요합니다. | 원터치결제 사용이 설정되어 있지 않은 상점에서 원터치결제 사용과 관련된 메서드인 setupOneTouchPay(), toggleOneTouchPay(), isOneTouchPayEnabled를 호출했을 때 발생하는 에러입니다. |
코어 API 별 에러
결제 승인
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | ALREADY_PROCESSED_PAYMENT | 이미 처리된 결제 입니다. | This is a payment that has already been processed. |
| 400 | PROVIDER_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
| 400 | EXCEED_MAX_CARD_INSTALLMENT_PLAN | 설정 가능한 최대 할부 개월 수를 초과했습니다. | Maximum number of installment months exceeded. (`installmentPlanMonths`) |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | NOT_ALLOWED_POINT_USE | 포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다. | Card point payment failed because the card cannot be used points. |
| 400 | INVALID_API_KEY | 잘못된 시크릿키 연동 정보 입니다. | Incorrect secret key. |
| 400 | INVALID_REJECT_CARD | 카드 사용이 거절되었습니다. 카드사 문의가 필요합니다. | Refer to card issuer/decline. |
| 400 | BELOW_MINIMUM_AMOUNT | 신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다. | Payment can be made from 100 won or more by credit card, and 200 won or more for account. |
| 400 | INVALID_CARD_EXPIRATION | 카드 정보를 다시 확인해주세요. (유효기간) | Please check the card expiration date information again. |
| 400 | INVALID_STOPPED_CARD | 정지된 카드 입니다. | This is a suspended card. |
| 400 | EXCEED_MAX_DAILY_PAYMENT_COUNT | 하루 결제 가능 횟수를 초과했습니다. | You have exceeded the number of daily payments. |
| 400 | NOT_SUPPORTED_INSTALLMENT_PLAN_CARD_OR_MERCHANT | 할부가 지원되지 않는 카드 또는 가맹점 입니다. | This card or merchant does not support installment. |
| 400 | INVALID_CARD_INSTALLMENT_PLAN | 할부 개월 정보가 잘못되었습니다. | The installment month information is incorrect. |
| 400 | NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN | 할부가 지원되지 않는 카드입니다. | This card does not support installment. |
| 400 | EXCEED_MAX_PAYMENT_AMOUNT | 하루 결제 가능 금액을 초과했습니다. | You have exceeded the amount you can pay per day. |
| 400 | NOT_FOUND_TERMINAL_ID | 단말기번호(Terminal Id)가 없습니다. 토스페이먼츠로 문의 바랍니다. | There is no Terminal Id. Please contact Toss Payments. |
| 400 | INVALID_AUTHORIZE_AUTH | 유효하지 않은 인증 방식입니다. | Invalid authentication |
| 400 | INVALID_CARD_LOST_OR_STOLEN | 분실 혹은 도난 카드입니다. | This is a lost or stolen card |
| 400 | RESTRICTED_TRANSFER_ACCOUNT | 계좌는 등록 후 12시간 뒤부터 결제할 수 있습니다. 관련 정책은 해당 은행으로 문의해주세요. | You can withdraw from this bank account after 12 hours from initial register. For related policies, please contact your bank. |
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 400 | INVALID_UNREGISTERED_SUBMALL | 등록되지 않은 서브몰입니다. 서브몰이 없는 가맹점이라면 안심클릭이나 ISP 결제가 필요합니다. | Not registered PG sub-mall business number. |
| 400 | NOT_REGISTERED_BUSINESS | 등록되지 않은 사업자 번호입니다. | Unregistered business registration number |
| 400 | EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT | 1일 출금 한도를 초과했습니다. | You have exceeded the one-day withdrawal limit. |
| 400 | EXCEED_MAX_ONE_TIME_WITHDRAW_AMOUNT | 1회 출금 한도를 초과했습니다. | You have exceeded the one-time withdrawal limit. |
| 400 | CARD_PROCESSING_ERROR | 카드사에서 오류가 발생했습니다. | The card company was not able to process the request. |
| 400 | EXCEED_MAX_AMOUNT | 거래금액 한도를 초과했습니다. | The transaction amount limit has been exceeded. |
| 400 | INVALID_ACCOUNT_INFO_RE_REGISTER | 유효하지 않은 계좌입니다. 계좌 재등록 후 시도해주세요. | Invalid account. Please re-register the account and try again. |
| 400 | NOT_AVAILABLE_PAYMENT | 결제가 불가능한 시간대입니다 | Payment is unavailable at this time. |
| 400 | UNAPPROVED_ORDER_ID | 아직 승인되지 않은 주문번호입니다. | This order id has not been approved for payment. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment declined due to insufficient balance. |
| 403 | REJECT_CARD_PAYMENT | 한도초과 혹은 잔액부족으로 결제에 실패했습니다. | Payment failed due to limit exceeded or insufficient balance. |
| 403 | REJECT_CARD_COMPANY | 결제 승인이 거절되었습니다. | Payment confirm is rejected |
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | Not allowed request |
| 403 | REJECT_TOSSPAY_INVALID_ACCOUNT | 선택하신 출금 계좌가 출금이체 등록이 되어 있지 않아요. 계좌를 다시 등록해 주세요. | Your account invalidated. Please register another account. |
| 403 | EXCEED_MAX_AUTH_COUNT | 최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요. | Maximum authentication attempts exceeded. |
| 403 | EXCEED_MAX_ONE_DAY_AMOUNT | 일일 한도를 초과했습니다. | You have exceeded your daily limit. |
| 403 | NOT_AVAILABLE_BANK | 은행 서비스 시간이 아닙니다. | It's not banking hour. |
| 403 | INVALID_PASSWORD | 결제 비밀번호가 일치하지 않습니다. | Incorrect password |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 403 | FDS_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) |
| 404 | NOT_FOUND_PAYMENT | 존재하지 않는 결제 정보 입니다. | Not found payment |
| 404 | NOT_FOUND_PAYMENT_SESSION | 결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다. | Payment session does not exist because the session time has expired. |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제가 완료되지 않았어요. 다시 시도해주세요. | Payment has not been completed. please try again. |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
| 500 | UNKNOWN_PAYMENT_ERROR | 결제에 실패했어요. 같은 문제가 반복된다면 은행이나 카드사로 문의해주세요. | Payment failed. If the same problem occurs, please contact your bank or credit card company. |
결제 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | FORBIDDEN_CONSECUTIVE_REQUEST | 반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요. | Repetitive requests are not allowed. Please try again in a few minutes. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 404 | NOT_FOUND_PAYMENT | 존재하지 않는 결제 정보 입니다. | Not found payment |
| 404 | NOT_FOUND | 존재하지 않는 정보 입니다. | Not found information |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제가 완료되지 않았어요. 다시 시도해주세요. | Payment has not been completed. please try again. |
결제 취소
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | ALREADY_CANCELED_PAYMENT | 이미 취소된 결제 입니다. | The payment has already been canceled. |
| 400 | INVALID_REFUND_ACCOUNT_INFO | 환불 계좌번호와 예금주명이 일치하지 않습니다. | `accountNumber` and holderName is not matched. |
| 400 | EXCEED_CANCEL_AMOUNT_DISCOUNT_AMOUNT | 즉시할인금액보다 적은 금액은 부분취소가 불가능합니다. | The cancel amount cannot exceed discount amount |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_REFUND_ACCOUNT_NUMBER | 잘못된 환불 계좌번호입니다. | Incorrect `accountNumber` |
| 400 | INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
| 400 | NOT_MATCHES_REFUNDABLE_AMOUNT | 잔액 결과가 일치하지 않습니다. | Balance results do not match. |
| 400 | PROVIDER_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
| 400 | REFUND_REJECTED | 환불이 거절됐습니다. 결제사에 문의 부탁드립니다. | The refund has been rejected. Please contact the respective payment provider. |
| 400 | ALREADY_REFUND_PAYMENT | 이미 환불된 결제입니다. | The payment has been refunded. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | NOT_CANCELABLE_AMOUNT | 취소 할 수 없는 금액 입니다. | This is a non-cancelable amount. |
| 403 | FORBIDDEN_CONSECUTIVE_REQUEST | 반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요. | Repetitive requests are not allowed. Please try again in a few minutes. |
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | Not allowed request |
| 403 | NOT_CANCELABLE_PAYMENT | 취소 할 수 없는 결제 입니다. | This is a non-cancelable payment. |
| 403 | EXCEED_MAX_REFUND_DUE | 환불 가능한 기간이 지났습니다. | Refundable date has passed. |
| 403 | NOT_ALLOWED_PARTIAL_REFUND_WAITING_DEPOSIT | 입금 대기중인 결제는 부분 환불이 불가합니다. | Partial refund is not available while pending deposit. |
| 403 | NOT_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. |
| 403 | NOT_AVAILABLE_BANK | 은행 서비스 시간이 아닙니다. | It's not banking hour. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 403 | NOT_CANCELABLE_PAYMENT_FOR_DORMANT_USER | 휴면 처리된 회원의 결제는 취소할 수 없습니다. | This is a non-cancelable payment. It is a dormant user account. |
| 404 | NOT_FOUND_PAYMENT | 존재하지 않는 결제 정보 입니다. | Not found payment |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
| 500 | FAILED_REFUND_PROCESS | 은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다. | The refund request failed due to a delay in the bank response time or a temporary error. |
| 500 | FAILED_METHOD_HANDLING_CANCEL | 취소 중 결제 시 사용한 결제 수단 처리과정에서 일시적인 오류가 발생했습니다. | A temporary error occurred while processing cancellation. |
| 500 | FAILED_PARTIAL_REFUND | 은행 점검, 해약 계좌 등의 사유로 부분 환불이 실패했습니다. | Partial refund failed due to bank check, account canceled, etc. |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제가 완료되지 않았어요. 다시 시도해주세요. | Payment has not been completed. please try again. |
카드 번호 결제
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_CARD_EXPIRATION | 카드 정보를 다시 확인해주세요. (유효기간) | Please check the card expiration date information again. |
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 400 | INVALID_CARD_PASSWORD | 카드 정보를 다시 확인해주세요. (비밀번호) | Please check the card information again. |
| 400 | INVALID_CARD_IDENTITY | 입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다. | The entered resident registration number/business number does not match the cardholder information. |
| 400 | INVALID_STOPPED_CARD | 정지된 카드 입니다. | This is a suspended card. |
| 400 | INVALID_REJECT_CARD | 카드 사용이 거절되었습니다. 카드사 문의가 필요합니다. | Refer to card issuer/decline. |
| 400 | INVALID_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. |
| 400 | NOT_SUPPORTED_CARD_TYPE | 지원되지 않는 카드 종류입니다. | This card type is not supported. |
| 400 | NOT_REGISTERED_CARD_COMPANY | 카드를 사용 등록 후 이용해주세요. | Please register the credit card before using it. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN | 할부가 지원되지 않는 카드입니다. | This card does not support installment. |
| 400 | INVALID_CARD_INSTALLMENT_PLAN | 할부 개월 정보가 잘못되었습니다. | The installment month information is incorrect. |
| 400 | NOT_SUPPORTED_INSTALLMENT_PLAN_CARD_OR_MERCHANT | 할부가 지원되지 않는 카드 또는 가맹점 입니다. | This card or merchant does not support installment. |
| 400 | INVALID_EMAIL | 유효하지 않은 이메일 주소 형식입니다. | Invalid email format |
| 400 | BELOW_MINIMUM_AMOUNT | 신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다. | Payment can be made from 100 won or more by credit card, and 200 won or more for account. |
| 400 | DUPLICATED_ORDER_ID | 이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요. | This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id. |
| 400 | INVALID_ORDER_ID | `orderId`는 영문 대소문자, 숫자, 특수문자(-, _) 만 허용합니다. 6자 이상 64자 이하여야 합니다. | `orderId` must be at least 6 and maximum 64 characters including upper and lower case alphabets, numbers, special characters (-, _). |
| 400 | NOT_ALLOWED_POINT_USE | 포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다. | Card point payment failed because the card cannot be used points. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | REJECT_CARD_PAYMENT | 한도초과 혹은 잔액부족으로 결제에 실패했습니다. | Payment failed due to limit exceeded or insufficient balance. |
| 403 | EXCEED_MAX_AUTH_COUNT | 최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요. | Maximum authentication attempts exceeded. |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment declined due to insufficient balance. |
| 403 | REJECT_CARD_COMPANY | 결제 승인이 거절되었습니다. | Payment confirm is rejected |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
| 500 | FAILED_DB_PROCESSING | 잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다. | A DB error occurred while processing with an invalid request value. |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제가 완료되지 않았어요. 다시 시도해주세요. | Payment has not been completed. please try again. |
| 500 | FAILED_CARD_COMPANY_RESPONSE | 카드사에서 에러가 발생했습니다. 잠시 후 다시 시도해 주세요. | An error occurred at the card company. Please try again in a few minutes. |
가상계좌 발급 요청
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | DUPLICATED_ORDER_ID | 이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요. | This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_REGISTRATION_NUMBER_TYPE | 유효하지 않은 등록 번호 타입입니다. | Invalid registration number type |
| 400 | INVALID_DATE | 날짜 데이터가 잘못 되었습니다. | The date data is invalid. |
| 400 | INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
| 400 | EXCEED_MAX_DUE_DATE | 가상 계좌의 최대 유효만료 기간을 초과했습니다. | Valid time for virtual account exceeded. (`dueDate`) |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
| 500 | FAILED_DB_PROCESSING | 잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다. | A DB error occurred while processing with an invalid request value. |
카드 자동결제 빌링키 발급 요청
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 400 | NOT_SUPPORTED_CARD_TYPE | 지원되지 않는 카드 종류입니다. | This card type is not supported. |
| 400 | INVALID_CARD_PASSWORD | 카드 정보를 다시 확인해주세요. (비밀번호) | Please check the card information again. |
| 400 | INVALID_CARD_EXPIRATION | 카드 정보를 다시 확인해주세요. (유효기간) | Please check the card expiration date information again. |
| 400 | INVALID_CARD_IDENTITY | 입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다. | The entered resident registration number/business number does not match the cardholder information. |
| 400 | INVALID_REJECT_CARD | 카드 사용이 거절되었습니다. 카드사 문의가 필요합니다. | Refer to card issuer/decline. |
| 400 | INVALID_STOPPED_CARD | 정지된 카드 입니다. | This is a suspended card. |
| 400 | INVALID_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. |
| 400 | NOT_REGISTERED_CARD_COMPANY | 카드를 사용 등록 후 이용해주세요. | Please register the credit card before using it. |
| 400 | INVALID_EMAIL | 유효하지 않은 이메일 주소 형식입니다. | Invalid email format |
| 400 | NOT_SUPPORTED_METHOD | 지원되지 않는 결제 수단입니다. | This payment method is not supported. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 403 | EXCEED_MAX_AUTH_COUNT | 최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요. | Maximum authentication attempts exceeded. |
| 403 | REJECT_CARD_COMPANY | 결제 승인이 거절되었습니다. | Payment confirm is rejected |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment declined due to insufficient balance. |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
카드 자동결제 승인
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_STOPPED_CARD | 정지된 카드 입니다. | This is a suspended card. |
| 400 | INVALID_REJECT_CARD | 카드 사용이 거절되었습니다. 카드사 문의가 필요합니다. | Refer to card issuer/decline. |
| 400 | INVALID_CARD_EXPIRATION | 카드 정보를 다시 확인해주세요. (유효기간) | Please check the card expiration date information again. |
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 400 | INVALID_BILL_KEY_REQUEST | 빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다. | Unauthorized billingKey or invalid billing transaction |
| 400 | NOT_SUPPORTED_CARD_TYPE | 지원되지 않는 카드 종류입니다. | This card type is not supported. |
| 400 | DUPLICATED_ORDER_ID | 이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요. | This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id. |
| 400 | NOT_SUPPORTED_INSTALLMENT_PLAN_CARD_OR_MERCHANT | 할부가 지원되지 않는 카드 또는 가맹점 입니다. | This card or merchant does not support installment. |
| 400 | INVALID_CARD_INSTALLMENT_PLAN | 할부 개월 정보가 잘못되었습니다. | The installment month information is incorrect. |
| 400 | NOT_MATCHES_CUSTOMER_KEY | 빌링 인증 고객키와 결제 요청 고객키가 일치하지 않습니다. | `customerKey` between billing auth request and payment request is not matching. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | BELOW_MINIMUM_AMOUNT | 신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다. | Payment can be made from 100 won or more by credit card, and 200 won or more for account. |
| 400 | NOT_REGISTERED_CARD_COMPANY | 카드를 사용 등록 후 이용해주세요. | Please register the credit card before using it. |
| 400 | NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN | 할부가 지원되지 않는 카드입니다. | This card does not support installment. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | REJECT_CARD_PAYMENT | 한도초과 혹은 잔액부족으로 결제에 실패했습니다. | Payment failed due to limit exceeded or insufficient balance. |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment declined due to insufficient balance. |
| 403 | REJECT_CARD_COMPANY | 결제 승인이 거절되었습니다. | Payment confirm is rejected |
| 403 | EXCEED_MAX_AUTH_COUNT | 최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요. | Maximum authentication attempts exceeded. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
| 500 | FAILED_DB_PROCESSING | 잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다. | A DB error occurred while processing with an invalid request value. |
| 500 | FAILED_CARD_COMPANY_RESPONSE | 카드사에서 에러가 발생했습니다. 잠시 후 다시 시도해 주세요. | An error occurred at the card company. Please try again in a few minutes. |
거래 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_DATE | 날짜 데이터가 잘못 되었습니다. | The date data is invalid. |
| 400 | INVALID_TRANSACTION_KEY | 잘못된 페이징 키 입니다. | Bad paging key. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
정산 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_DATE | 날짜 데이터가 잘못 되었습니다. | The date data is invalid. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
- 에러 코드로
INVALID_REQUEST가 돌아왔다면dateType이 제대로 들어갔는지 확인해보세요.
수동 정산
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | Not allowed request |
| 404 | NOT_FOUND_PAYMENT | 존재하지 않는 결제 정보 입니다. | Not found payment |
| 404 | NOT_FOUND | 존재하지 않는 정보 입니다. | Not found information |
| 404 | NOT_FOUND_METHOD | 존재하지 않는 결제 수단 입니다. | Not found payment method |
현금영수증 발급 요청
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | PROVIDER_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
| 400 | DUPLICATED_CASH_RECEIPT | 이미 현금영수증이 발급된 주문입니다. | This is a duplicate request that has already been issued. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_REQUIRED_PARAM | 필수 파라미터가 누락되었습니다. | The required parameter is missing. |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제가 완료되지 않았어요. 다시 시도해주세요. | Payment has not been completed. please try again. |
현금영수증 발급 취소 요청
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | Not allowed request |
| 404 | NOT_FOUND_RECEIPT | 존재하지 않는 현금영수증 정보 입니다. | Cash receipt information does not exist. |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
현금영수증 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | API_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) |
| 400 | INVALID_BUSINESS_NUMBER | 사업자 번호는 10자리여야 합니다. | The business number must be 10 digits long. |
| 400 | INVALID_REQUIRED_PARAM | 필수 파라미터가 누락되었습니다. | The required parameter is missing. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | INCORRECT_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 |
서브몰 등록
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | ACCOUNT_OWNER_CHECK_FAILED | 계좌소유주 정보를 가져오는데 실패했습니다. `bank`와 `accountNumber` 값을 확인해주세요. | Failed to get account holder. Please check `bank` and `accountNumber` parameter. |
| 400 | INVALID_ACCOUNT_NUMBER | 계좌번호가 올바르지 않습니다. | Invalid account number |
| 400 | ALREADY_EXIST_SUBMALL | 이미 존재하는 서브몰입니다. | Duplicated `submallId` |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
서브몰 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
서브몰 수정
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | ACCOUNT_OWNER_CHECK_FAILED | 계좌소유주 정보를 가져오는데 실패했습니다. `bank`와 `accountNumber` 값을 확인해주세요. | Failed to get account holder. Please check `bank` and `accountNumber` parameter. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
| 400 | INVALID_ACCOUNT_NUMBER | 계좌번호가 올바르지 않습니다. | Invalid account number |
| 404 | NOT_FOUND | 존재하지 않는 정보 입니다. | Not found information |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
서브몰 삭제
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 404 | NOT_FOUND | 존재하지 않는 정보 입니다. | Not found information |
지급 가능한 잔액 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_DATE | 날짜 데이터가 잘못 되었습니다. | The date data is invalid. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | INCORRECT_BASIC_AUTH_FORMAT | 잘못된 요청입니다. ':' 를 포함해 인코딩해주세요. | Invalid request. Please encode including the ':' character. |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
지급대행 요청
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_PAYABLE_DATE | 지급일자가 올바르지 않습니다. | The payment date is incorrect. |
| 400 | NOT_ENOUGH_AMOUNT | 지급가능한 금액을 초과했습니다. | Payout amount exceeded. |
| 400 | DUPLICATED_REQUEST | 중복된 요청입니다. | This is a duplicate request. |
| 400 | NOT_ALLOWED_HOLIDAY | 공휴일은 지급일로 선택할 수 없습니다. | Public holidays cannot be selected as payment dates. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | BELOW_ZERO_AMOUNT | 금액은 0보다 커야 합니다. | `amount` should be greater than 0. |
| 404 | NOT_FOUND_SUBMALL | 존재하지 않는 서브몰입니다. | Not found `submallId` |
| 404 | NOT_FOUND_PAYMENT | 존재하지 않는 결제 정보 입니다. | Not found payment |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
지급대행 요청 취소
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | DUPLICATED_REQUEST | 중복된 요청입니다. | This is a duplicate request. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 404 | PAYOUT_NOT_FOUND | 존재하지 않는 지급대행 입니다. | The payout does not exist. |
지급대행 단건 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 404 | PAYOUT_NOT_FOUND | 존재하지 않는 지급대행 입니다. | The payout does not exist. |
전체 에러 목록
코어 API에서 발생할 수 있는 전체 에러 목록입니다.
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | ACCOUNT_OWNER_CHECK_FAILED | 계좌 소유주를 가져오는데 실패했습니다. 은행코드, 계좌번호를 확인해주세요. | Failed to get account holder. Please check your bank code and account number. |
| 400 | ALREADY_CANCELED_PAYMENT | 이미 취소된 결제 입니다. | The payment has already been canceled. |
| 400 | ALREADY_CLOSE_ACCOUNT | 이미 해지된 계좌입니다. | This account has already been closed. |
| 400 | ALREADY_COMPLETED_PAYMENT | 이미 완료된 결제 입니다. | This is a payment that has already been completed. |
| 400 | ALREADY_EXIST_SUBMALL | 이미 존재하는 서브몰입니다. | This sub-mall is already exists. |
| 400 | ALREADY_PROCESSED_PAYMENT | 이미 처리된 결제 입니다. | This is a payment that has already been processed. |
| 400 | ALREADY_REFUND_PAYMENT | 이미 환불된 결제입니다. | The payment has already been refunded. |
| 400 | ALREADY_REFUNDING_PAYMENT | 이미 환불 중인 결제입니다. | The payment is already being refunded. |
| 400 | API_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) |
| 400 | BELOW_MINIMUM_AMOUNT | 신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다. | Payment can be made from 100 won or more by credit card, and 200 won or more for account. |
| 400 | BELOW_ZERO_AMOUNT | 금액은 0보다 커야 합니다. | The amount must be greater than 0. |
| 400 | DUPLICATED_CASH_RECEIPT | 이미 현금영수증이 발급된 주문입니다. | This is a duplicate request that has already been issued. |
| 400 | DUPLICATED_ORDER_ID | 이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요. | This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id. |
| 400 | DUPLICATED_REQUEST | 중복된 요청입니다. | This is a duplicate request. |
| 400 | EXCEED_MAX_AMOUNT | 거래금액 한도를 초과했습니다. | The transaction amount limit has been exceeded. |
| 400 | EXCEED_MAX_CARD_INSTALLMENT_PLAN | 설정 가능한 최대 할부 개월 수를 초과했습니다. | You have exceeded the maximum number of installment months that can be set. |
| 400 | EXCEED_MAX_DAILY_PAYMENT_COUNT | 하루 결제 가능 횟수를 초과했습니다. | You have exceeded the number of daily payments. |
| 400 | EXCEED_MAX_DUE_DATE | 가상 계좌의 최대 유효만료 기간을 초과했습니다. | You have exceeded the maximum expiry period for your virtual account. |
| 400 | EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT | 1일 출금 한도를 초과했습니다. | You have exceeded the one-day withdrawal limit. |
| 400 | EXCEED_MAX_ONE_TIME_WITHDRAW_AMOUNT | 1회 출금 한도를 초과했습니다. | You have exceeded the one-time withdrawal limit. |
| 400 | EXCEED_MAX_PAYMENT_AMOUNT | 하루 결제 가능 금액을 초과했습니다. | You have exceeded the amount you can pay per day. |
| 400 | EXCEED_MAX_QUERY_LIMIT | 최대 조회 개수를 초과했습니다. | You have exceeded the maximum number of query limit. |
| 400 | EXCEED_MAX_VALID_HOURS | 가상 계좌의 최대 유효시간을 초과했습니다. | The maximum validity time of the virtual account has been exceeded. |
| 400 | EXCEED_MIN_CARD_INSTALLMENT_PLAN | 설정 가능한 최소 할부 개월 수를 1개월 이상으로 설정해주세요. | The minimum installment month must be set to at least 1 month. |
| 400 | EXCEED_UNKNOWN_CASE | 한도 초과 되었습니다. | A threashold exceeds |
| 400 | INCORRECT_FAIL_URL_FORMAT | 잘못된 failUrl 입니다. | Invalid format: failUrl |
| 400 | INCORRECT_SUCCESS_URL_FORMAT | 잘못된 successUrl 입니다. | Invalid format: successUrl |
| 400 | INVALID_ACCOUNT_NOT_CORRECT_BANK | 입력하신 계좌는 해당 은행의 계좌가 아닙니다. | The account you entered is not a bank account. |
| 400 | INVALID_ACCOUNT_NUMBER | 계좌번호가 올바르지 않습니다. | Account number is incorrect. |
| 400 | INVALID_ACCOUNT_NUMBER_OR_UNAVAILABLE | 잘못된 계좌번호이거나 서비스 불가한 계좌입니다. | Wrong account number or account unavailable. |
| 400 | INVALID_API_KEY | 잘못된 시크릿키 연동 정보 입니다. | Incorrect secret key. |
| 400 | INVALID_AUTHORIZE_AUTH | 잘못된 인증 방식입니다. | Incorrect authentication. |
| 400 | INVALID_AUTHORIZE_AUTH_TYPE_GIFT_CERTIFICATE | 유효하지 않은 상품권 결제 인증 타입입니다. | This is an invalid gift certificate payment authentication type. |
| 400 | INVALID_BANK | 유효하지 않은 은행입니다. | It is an Invalid bank. |
| 400 | INVALID_BILL_KEY_REQUEST | 빌링키 인증이 완료되지 않았거나 유효하지 않은 빌링 거래 건입니다. | Billing key authentication has not been completed or is an invalid billing transaction. |
| 400 | INVALID_BILLING_AUTH | 유효하지 않은 빌링 인증입니다. | Invalid billing authentication. |
| 400 | INVALID_BIRTH_DAY_FORMAT | 생년월일 정보는 6자리의 yyMMdd 형식이어야 합니다. 사업자등록번호는 10자리의 숫자여야 합니다. | The birth date format must be in 6 length of yyMMdd format. |
| 400 | INVALID_BUSINESS_NUMBER | 사업자 등록번호가 잘못되었습니다. | The business registration number is incorrect. |
| 400 | INVALID_CARD | 카드 입력정보가 올바르지 않습니다. | Card input information is incorrect. |
| 400 | INVALID_CARD_COMPANY | 유효하지 않은 카드사입니다. | It is an invalid card company. |
| 400 | INVALID_CARD_EXPIRATION | 카드 정보를 다시 확인해주세요.(유효기간) Please check the card expiration date information again. | |
| 400 | INVALID_CARD_IDENTITY | 입력하신 주민번호/사업자번호가 카드 소유주 정보와 일치하지 않습니다. | The entered resident registration number/business number does not match the cardholder information. |
| 400 | INVALID_CARD_INSTALLMENT_AMOUNT | 할부금액 잘못 되었습니다. | The installment amount is incorrect. |
| 400 | INVALID_CARD_INSTALLMENT_PLANS_WITH_MAX_AND_SINGLE | cardInstallmentPlan과 maxCardInstallmentPlan은 같이 사용할 수 없습니다. | cardInstallmentPlan and maxCardInstallmentPlan cannot be used together. |
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 400 | INVALID_CARD_PASSWORD | 카드 정보를 다시 확인해주세요.(비밀번호) Please check the card information again. | |
| 400 | INVALID_CASH_RECEIPT_INFO | 현금 영수증 정보가 잘못되었습니다. | Cash receipt information is incorrect. |
| 400 | INVALID_CLIENT_KEY | 잘못된 클라이언트 연동 정보 입니다. | Incorrect client key. |
| 400 | INVALID_CURRENCY | 잘못된 통화 값입니다. | Invalid currency value. |
| 400 | INVALID_CUSTOMER_KEY | customerKey는 영문 대소문자, 숫자, 특수문자 -, *, =, ., @로 2자 이상 255자 이하여야 합니다. | customerKey must be at least 2 and maximum 20 upper and lower case alphabets, numbers, special characters (-, _, =, ., @). |
| 400 | INVALID_DATE | 날짜 데이터가 잘못 되었습니다. | The date data is invalid. |
| 400 | INVALID_EASY_PAY | 간편결제 입력정보가 올바르지 않습니다. | The easy payment input information is incorrect. |
| 400 | INVALID_EMAIL | 이메일 주소 형식에 맞지 않습니다. | It doesn't match the email address format. |
| 400 | INVALID_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. |
| 400 | INVALID_IDENTIFICATION_TYPE | 유효하지 않은 본인 인증 타입입니다. | This is an invalid authentication type |
| 400 | INVALID_ISO_DATE_FORMAT | 시간 일시 형식이 잘못되었습니다. 시간 형식은 ISO 8601 형식을 준수해야 합니다. | The format is incorrect. The time format must conform to ISO 8601 format. |
| 400 | INVALID_ORDER_ID | orderId는 영문 대소문자, 숫자, 특수문자(-, _) 만 허용합니다. 6자 이상 64자 이하여야 합니다. | The order id must be at least 6 and maximum 64 upper and lower case alphabets, numbers, special characters (-, _, =). |
| 400 | INVALID_ORDER_NAME | 주문 이름은 100자 이하여야 합니다. | The order name must be 100 characters or less. |
| 400 | INVALID_PAGING_KEY | 잘못된 페이징 키 입니다. | Bad paging key. |
| 403 | INVALID_PASSWORD | 결제 비밀번호가 일치하지 않습니다. | Payment password does not match. |
| 400 | INVALID_PAYABLE_DATE | 지급일자가 올바르지 않습니다. | The payment date is incorrect. |
| 400 | INVALID_PAYMENT_KEY | 잘못된 결제 키 입니다. | Invalid payment key. |
| 400 | INVALID_REFUND_ACCOUNT_INFO | 환불 계좌번호와 예금주명이 일치하지 않습니다. | Refund account number and account holder name do not match. |
| 400 | INVALID_REFUND_ACCOUNT_NUMBER | 잘못된 환불 계좌번호입니다. | Incorrect refund account number. |
| 400 | INVALID_REFUND_AMOUNT | 잘못된 환불 금액입니다. | Incorrect refund amount. |
| 400 | INVALID_REJECT_CARD | 카드 사용이 거절되었습니다. 카드사 문의가 필요합니다. | Refer to card issuer/decline. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_REQUIRED_PARAM | 필수 파라미터가 누락되었습니다. | The installment amount is incorrect. |
| 400 | INVALID_STOPPED_CARD | 정지된 카드 입니다. | This is a suspended card. |
| 400 | INVALID_SUBMALL_ID | 유효하지 않은 서브몰 ID 입니다. 영문, 숫자 20글자 이하로 입력해주세요. | This submall ID is not valid. Please enter 20 letters or less in alphabets or numbers. |
| 400 | INVALID_SUCCESS_URL | successUrl 값은 필수 값입니다. | The successUrl value is a required value. |
| 400 | INVALID_TEST_CODE | 유효하지 않은 테스트 코드입니다. | Invalid test code |
| 400 | INVALID_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 |
| 400 | INVALID_URL | url 은 http, https 를 포함한 주소 형식이어야 합니다. | url must be in address format including http and https. |
| 400 | INVALID_URL_FORMAT | 잘못된 URL 형식입니다. | Invalid URL format. |
| 400 | INVALID_VALID_HOURS_WITH_DUE_DATE_AND_SINGLE | validHours와 dueDate는 같이 사용할 수 없습니다. | validHours and dueDate cannot be used together. |
| 400 | INVALID_VIRTUAL_ACCOUNT_TYPE | 유효하지 않은 가상계좌 타입입니다. | Invalid virtual account type. |
| 400 | MAINTAINED_METHOD | 현재 점검 중 입니다. | The method is being maintained now |
| 400 | NOT_ALLOWED_HOLIDAY | 공휴일은 지급일로 선택할 수 없습니다. | Public holidays cannot be selected as payment dates. |
| 400 | NOT_ALLOWED_INSTALLMENT_BELOW_AMOUNT | 해당 카드는 10000원 미만 할부 거래가 불가한 카드입니다. | This card cannot be used for installment transactions less than KRW 10000. |
| 400 | NOT_ALLOWED_POINT_USE | 포인트 사용이 불가한 카드로 카드 포인트 결제에 실패했습니다. | Card point payment failed because the card cannot be used points. |
| 400 | NOT_ENOUGH_AMOUNT | 지급가능한 금액을 초과했습니다. | The payable amount has been exceeded. |
| 400 | NOT_FOUND_TERMINAL_ID | 단말기번호(Terminal Id)가 없습니다. 토스페이먼츠로 문의 바랍니다. | There is no Terminal Id. Please contact Toss Payments. |
| 400 | NOT_MATCH_PAYEE_NAME | 수취인 성명이 불일치 합니다. | The payee's name is inconsistent. |
| 400 | NOT_MATCHES_CUSTOMER_KEY | 빌링 인증 고객키와 결제 요청 고객키가 일치하지 않습니다. | The billing authentication customer key and the payment request customer key do not match. |
| 400 | NOT_MATCHES_REFUNDABLE_AMOUNT | 잔액 결과가 일치하지 않습니다. | Balance results do not match. |
| 400 | NOT_REGISTERED_BUSINESS | 등록되지 않은 사업자 번호입니다. | Unregsitered business registration number |
| 400 | NOT_REGISTERED_SUBMALL | PG 하위몰 사업자번호가 등록되어 있지 않습니다. | PG sub-mall business number is not registered. |
| 400 | NOT_SUPPORTED_CARD_TYPE | 지원되지 않는 카드 종류입니다. | This card type is not supported. |
| 400 | NOT_SUPPORTED_CARRIER | 지원되지 않는 이동 통신사입니다. | Unsupported carrier. |
| 400 | NOT_SUPPORTED_METHOD | 지원되지 않는 결제수단입니다. | This payment method is not supported. |
| 400 | NOT_SUPPORTED_METHOD | 지원되지 않는 결제수단입니다. | This payment method is not supported. |
| 400 | NOT_SUPPORTED_MONTHLY_INSTALLMENT_PLAN | 할부 또는 무이자 할부가 지원되지 않는 카드입니다. | This card does not support installment or interest-free installment. |
| 400 | NOT_SUPPORTED_PROCESS | 지원되지 않는 작업입니다. | This operation is not supported. |
| 400 | NOT_SUPPORTED_USD | 선택하신 카드 또는 결제수단은 달러 결제가 불가합니다. | The selected card or payment method cannot be paid in dollars. |
| 400 | PAY_PROCESS_ABORTED | 결제가 취소되었거나 진행되지 않았습니다. | Payment has been canceled or has not been processed. |
| 400 | PAY_PROCESS_CANCELED | 결제가 사용자에 의해 취소되었습니다. | Payment has been canceled by the customer. |
| 400 | REFUND_REJECTED | 환불이 거절됐습니다. 결제사에 문의 부탁드립니다. | The refund has been rejected. Please contact the respective payment provider. |
| 400 | REQUIRED_ACCOUNT_KEY | 고정계좌는 발급용 고객키 값이 필수입니다. | For fixed accounts, a customer key value is required. |
| 400 | REQUIRED_AMOUNT | 금액 값이 필수입니다. | Amount value is required. |
| 400 | USER_ACCOUNT_ON_HOLD | 계정이 사용 불가능한 상태입니다. | Account is on hold. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | This is an unauthenticated secret key or client key. |
| 403 | EXCEED_MAX_AUTH_COUNT | 최대 인증 횟수를 초과했습니다. 카드사로 문의해주세요. | The maximum number of authentications has been exceeded. Please contact your credit card company. |
| 403 | EXCEED_MAX_REFUND_AMOUNT | 하루 또는 한달 환불 가능한 금액을 초과했습니다. | This merchant have exceeded your daily or monthly refundable amount. |
| 403 | EXCEED_MAX_REFUND_DUE | 환불 가능한 기간이 초과했습니다. | The refundable period has been exceeded. |
| 403 | FORBIDDEN_CONSECUTIVE_REQUEST | 반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요. | Repetitive requests are not allowed. Please try again in a few minutes. |
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | This request is not allowed. |
| 403 | NOT_ALLOWED_CHANGING_ACCOUNT | 이미 입금, 반납된 계좌의 정보 변경은 불가합니다. | It is not possible to change the information of the account that has already been deposited or returned. |
| 403 | NOT_ALLOWED_PARTIAL_REFUND | 에스크로 주문, 현금 카드 결제 등의 사유로 부분 환불이 불가합니다. | Partial refunds are not available for reasons such as escrow or cash payment. |
| 403 | NOT_ALLOWED_PARTIAL_REFUND_WAITING_DEPOSIT | 입금 대기중인 결제는 부분 환불이 불가합니다. | Partial refunds are not available while pending deposit. |
| 403 | NOT_ALLOWED_REFUND_BANK | 환불 가능한 은행이 아닙니다. | Not a refundable bank. |
| 403 | NOT_AVAILABLE_BANK | 은행 서비스 시간이 아닙니다. | Not bank service time. |
| 403 | NOT_CANCELABLE_AMOUNT | 취소 할 수 없는 금액 입니다. | This is a non-cancelable amount. |
| 403 | NOT_CANCELABLE_PAYMENT | 취소 할 수 없는 결제 입니다. | This is a non-cancelable payment. |
| 403 | NOT_SUPPORTED_REFUND | 환불 가능한 상점이 아닙니다. | Not a refundable merchant. |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment failed due to insufficient balance |
| 403 | REJECT_CARD_COMPANY | 결제 승인이 거절되었습니다. | Payment confirm is rejected |
| 404 | NOT_FOUND | 존재하지 않는 정보 입니다. | This information does not exist. |
| 404 | NOT_FOUND_BILLING | 존재하지 않는 빌링 결제 인증 정보 입니다. | Billing payment authentication information that does not exist. |
| 404 | NOT_FOUND_HTTP_METHOD | 존재하지 않는 HTTP 메소드 접근입니다. | This HTTP method does not allowed. |
| 404 | NOT_FOUND_MERCHANT | 존재하지 않는 상점 정보 입니다. | The merchant does not exist. |
| 404 | NOT_FOUND_MERCHANT_INTEGRATION | 존재하지 않는 상점 연동 정보 입니다. | The integration information does not exist. |
| 404 | NOT_FOUND_METHOD | 존재하지 않는 결제수단 입니다. | This payment method does not exist. |
| 404 | NOT_FOUND_METHOD_IN_GROUP | 같은 그룹내에 존재하지 않는 결제수단 입니다. | This payment method does not exist in the same group |
| 404 | NOT_FOUND_METHOD_OWNERSHIP | 결제수단의 소유자가 아닙니다. | This method ownership is not correct. |
| 404 | NOT_FOUND_PAYMENT | 존재하지 않는 결제 정보 입니다. | The payment does not exist. |
| 404 | NOT_FOUND_PAYMENT_SESSION | 결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다. | Payment session does not exist because the session time has expired. |
| 404 | NOT_FOUND_SUBMALL | 존재하지 않는 서브몰입니다. | This sub-mall does not exist. |
| 404 | PAYOUT_NOT_FOUND | 존재하지 않는 지급대행 입니다. | The payout does not exist. |
| 500 | FAILED_BILL_KEY_AUTH_CREATION | 빌링 결제 인증 중 키 생성에 실패했습니다. 잠시 후 다시 시도해주세요. | Key generation failed during billing payment verification. Please try again in a few minutes. |
| 500 | FAILED_BILLING_AUTO_CANCEL | 빌링 자동결제 취소에 일시적인 오류가 발생했습니다. | A temporary error occurred while billing auth cancellation. |
| 500 | FAILED_DB_PROCESSING | 잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다. | A DB error occurred while processing with an invalid request value. |
| 500 | FAILED_HASH_DATA_CREATION | 해시 데이터 생성 중 오류가 발생했습니다. | An error occurred while generating hash data. |
| 500 | FAILED_INTERNAL_SYSTEM_PROCESSING | 내부 시스템 처리 작업이 실패했습니다. 잠시 후 다시 시도해주세요. | Internal system processing operation has failed. Please try again in a few minutes. |
| 500 | FAILED_METHOD_HANDLING | 결제 중 선택한 결제수단 처리에 일시적인 오류가 발생했습니다. | There was a temporary error in processing the payment method you selected during checkout. |
| 500 | FAILED_METHOD_HANDLING_CANCEL | 취소 중 결제 시 사용한 결제수단 처리과정에서 일시적인 오류가 발생했습니다. | A temporary error occurred while processing cancellation. |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제 기관(카드사, 은행, 국세청 등) 오류입니다. 결제 기관에서 보내 준 에러 메시지가 표시됩니다. | Provider error. The error message received from provider will be displayed. |
| 500 | FAILED_REFUND_PROCESS | 은행 응답시간 지연이나 일시적인 오류로 환불요청에 실패했습니다. | The refund request failed due to a delay in the bank response time or a temporary error. |
| 500 | COMMON_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | A temporary error has occurred. Please try again in a few minutes. |
| 500 | UNKNOWN_ERROR | 확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요. | An unknown error occurred. Please try again in a few minutes. |
브랜드페이 API 별 에러
미동의 약관 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_REQUIRED_PARAM | 필수 파라미터가 누락되었습니다. | The required parameter is missing. |
| 400 | NOT_SUPPORTED_TERM_SCOPE | 가능한 약관 조합이 아닙니다. | The term scope combination is not valid |
약관 동의
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | REQUIRED_TERMS | 필수 약관에 모두 동의해주세요. | Please agree to all required terms |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_REQUIRED_PARAM | 필수 파라미터가 누락되었습니다. | The required parameter is missing. |
| 400 | NOT_SUPPORTED_TERM_SCOPE | 가능한 약관 조합이 아닙니다. | The term scope combination is not valid |
Access Token 발급
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_PHONE | 전화번호 형식에 맞지 않습니다. 전화번호에는 특수문자가 포함될 수 없습니다. | It doesn't fit the phone number format. Phone numbers cannot contain special characters. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | ALREADY_REGISTERED_CUSTOMER_CI | 이미 가입된 정보입니다. | This information has already been signed up. |
| 400 | NOT_SUPPORTED_AGE | 만 14세 이상 고객만 이용 가능합니다. | Only available to customers over the age of 14. |
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | Not allowed request |
| 403 | FORBIDDEN_CONSECUTIVE_REQUEST | 반복적인 요청은 허용되지 않습니다. 잠시 후 다시 시도해주세요. | Repetitive requests are not allowed. Please try again in a few minutes. |
| 403 | NOT_UPDATE_AUTHORIZATION_CODE | 인증코드를 갱신하지 않았습니다. | You do not update authorization code. |
| 403 | EXPIRED_AUTHORIZATION_CODE | 만료된 인증코드 값입니다. | The authorization code had been expired. |
| 403 | NOT_MATCHES_ENROLLED_CUSTOMER_KEY | 등록된 고객키와 accessToken 요청 고객키가 일치하지 않습니다. | The enrolled customer key and the accessToken request customer key do not match. |
| 403 | REQUIRED_DORMANT_VERIFICATION | 장기간 서비스 미사용으로 인한 휴면 상태로 계정이 잠겼습니다. 본인 인증으로 휴면 해제 후 다시 시도해주세요. | Account has been dormant due to long-term non-use of service. Please verify your identity and try again. |
| 404 | NOT_FOUND_CUSTOMER | 유효한 고객 정보가 없습니다. | There is no valid customer information. |
| 404 | NOT_FOUND_CUSTOMER_SESSION | 고객 세션을 찾을 수 없습니다. | No customer sessions were found. |
| 404 | NOT_FOUND_AUTHORIZATION_CODE | 인증코드 값을 찾을 수 없습니다. | The authorization code value could not be found. |
| 500 | FAILED_DB_PROCESSING | 잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다. | A DB error occurred while processing with an invalid request value. |
SecretKey로 결제수단 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 404 | NOT_FOUND_CUSTOMER | 유효한 고객 정보가 없습니다. | There is no valid customer information. |
카드 결제수단 삭제
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 404 | NOT_FOUND_METHOD | 존재하지 않는 결제 수단 입니다. | Not found payment method |
| 404 | NOT_FOUND_PAYMENT_METHOD | 존재하지 않는 결제 수단 입니다. | This payment method does not exist. |
| 404 | NOT_FOUND_CUSTOMER_SESSION | 고객 세션을 찾을 수 없습니다. | No customer sessions were found. |
| 500 | FAILED_CARD_COMPANY | 카드사 점검 중으로 다른 카드를 이용해 주세요. | Please use another card while checking the credit card company system. |
| 500 | UNKNOWN_ERROR | 확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요. | An unknown error occurred. Please try again in a few minutes. |
계좌 결제수단 삭제
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | MAINTAINED_METHOD | 현재 점검 중 입니다. | Under maintenance. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
결제 승인
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_CARD_INSTALLMENT_PLAN | 할부 개월 정보가 잘못되었습니다. | The installment month information is incorrect. |
| 400 | INVALID_UNREGISTERED_SUBMALL | 등록되지 않은 서브몰입니다. 서브몰이 없는 가맹점이라면 안심클릭이나 ISP 결제가 필요합니다. | Not registered PG sub-mall business number. |
| 400 | EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT | 1일 출금 한도를 초과했습니다. | You have exceeded the one-day withdrawal limit. |
| 400 | INVALID_API_KEY | 잘못된 시크릿키 연동 정보 입니다. | Incorrect secret key. |
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 403 | FORBIDDEN_REQUEST | 허용되지 않은 요청입니다. | Not allowed request |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment declined due to insufficient balance. |
| 403 | REJECT_CARD_PAYMENT | 한도초과 혹은 잔액부족으로 결제에 실패했습니다. | Payment failed due to limit exceeded or insufficient balance. |
| 403 | EXCEED_MAX_ONE_DAY_AMOUNT | 일일 한도를 초과했습니다. | You have exceeded your daily limit. |
| 403 | SUSPECTED_PHISHING_PAYMENT | 결제에 실패했습니다. 피싱사고 의심 거래입니다. | Payment rejected due to suspected phishing scam. |
| 404 | NOT_FOUND_PAYMENT_SESSION | 결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다. | Payment session does not exist because the session time has expired. |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제가 완료되지 않았어요. 다시 시도해주세요. | Payment has not been completed. please try again. |
| 500 | FAILED_OPEN_BANKING_PROCESSING | 오픈뱅킹 통신 장애입니다. 잠시 후 다시 시도해주세요. | The open banking communication failure. Please try again in a few minutes. |
자동결제 실행
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | BELOW_MINIMUM_AMOUNT | 신용카드는 결제금액이 100원 이상, 계좌는 200원이상부터 결제가 가능합니다. | Payment can be made from 100 won or more by credit card, and 200 won or more for account. |
| 400 | DUPLICATED_ORDER_ID | 이미 승인 및 취소가 진행된 중복된 주문번호 입니다. 다른 주문번호로 진행해주세요. | This is a duplicate order id that has already been approved or canceled. Please proceed with a different order id. |
| 400 | EXCEED_MAX_ONE_DAY_WITHDRAW_AMOUNT | 1일 출금 한도를 초과했습니다. | You have exceeded the one-day withdrawal limit. |
| 400 | INVALID_ACCOUNT_INFO_RE_REGISTER | 유효하지 않은 계좌입니다. 계좌 재등록 후 시도해주세요. | Invalid account. Please re-register the account and try again. |
| 400 | INVALID_CARD_EXPIRATION | 카드 정보를 다시 확인해주세요. (유효기간) | Please check the card expiration date information again. |
| 400 | INVALID_CARD_INFO_RE_REGISTER | 유효하지 않은 카드입니다. 카드 재등록 후 시도해주세요. | Invalid card. Please re-register the card and try again. |
| 400 | INVALID_CARD_INSTALLMENT_AMOUNT | 할부금액 잘못 되었습니다. | The installment amount is incorrect. |
| 400 | INVALID_CARD_LOST_OR_STOLEN | 분실 혹은 도난 카드입니다. | This is a lost or stolen card |
| 400 | INVALID_CARD_NUMBER | 카드번호를 다시 확인해주세요. | Please check your card number again. |
| 400 | INVALID_LEGAL_REGISTERED_ACCOUNT | 법적등록 계좌입니다. | This is an legal registered account. |
| 400 | INVALID_REJECT_CARD | 카드 사용이 거절되었습니다. 카드사 문의가 필요합니다. | Refer to card issuer/decline. |
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | The bad request. |
| 400 | INVALID_STOPPED_ACCOUNT | 정지된 계좌 입니다. | This is a suspended account. |
| 400 | INVALID_STOPPED_CARD | 정지된 카드 입니다. | This is a suspended card. |
| 400 | MAINTAINED_METHOD | 현재 점검 중 입니다. | Under maintenance. |
| 400 | NOT_SUPPORTED_METHOD | 지원되지 않는 결제 수단입니다. | This payment method is not supported. |
| 400 | PROVIDER_ERROR | 일시적인 오류가 발생했습니다. 잠시 후 다시 시도해주세요. | This is temporary error. Please try again in a few minutes. |
| 400 | RESTRICTED_TRANSFER_ACCOUNT | 계좌는 등록 후 12시간 뒤부터 결제할 수 있습니다. 관련 정책은 해당 은행으로 문의해주세요. | You can withdraw from this bank account after 12 hours from initial register. For related policies, please contact your bank. |
| 400 | INVALID_REQUIRED_PARAM | 필수 파라미터가 누락되었습니다. | The required parameter is missing. |
| 400 | NOT_SUPPORTED_BILLING_MERCHANT | 자동 결제를 등록한 상점이 아닙니다. 자동 결제 사용을 활성화해주세요. | This merchant is not registered to use billing payments. |
| 400 | REQUIRED_BILLING_TERMS | 자동 결제 이용약관에 동의해야 합니다. | Please agree to billing terms. |
| 403 | EXCEED_MAX_ONE_DAY_AMOUNT | 일일 한도를 초과했습니다. | You have exceeded your daily limit. |
| 403 | FAILED_PAYMENT_CONFIRM | 결제 승인이 실패하였습니다. | Payment approval failed. |
| 403 | FORBIDDEN_DORMANT_OR_WITHDRAWAL_CUSTOMER | 휴면고객이거나 탈퇴한 고객입니다. | You are a dormant customer or a member who has been withdrawn. |
| 403 | INVALID_PASSWORD | 결제 비밀번호가 일치하지 않습니다. | Incorrect password |
| 403 | REJECT_ACCOUNT_PAYMENT | 잔액부족으로 결제에 실패했습니다. | Payment declined due to insufficient balance. |
| 403 | REJECT_CARD_COMPANY | 결제 승인이 거절되었습니다. | Payment confirm is rejected |
| 403 | REJECT_CARD_PAYMENT | 한도초과 혹은 잔액부족으로 결제에 실패했습니다. | Payment failed due to limit exceeded or insufficient balance. |
| 403 | SUSPECTED_PHISHING_PAYMENT | 결제에 실패했습니다. 피싱사고 의심 거래입니다. | Payment rejected due to suspected phishing scam. |
| 404 | NOT_FOUND_CUSTOMER | 유효한 고객 정보가 없습니다. | There is no valid customer information. |
| 404 | NOT_FOUND_METHOD | 존재하지 않는 결제 수단 입니다. | Not found payment method |
| 404 | NOT_FOUND_METHOD_OWNERSHIP | 결제수단의 소유자가 아닙니다. | Not found method ownership |
| 500 | FAILED_CARD_COMPANY | 카드사 점검 중으로 다른 카드를 이용해 주세요. | Please use another card while checking the credit card company system. |
| 500 | FAILED_DB_PROCESSING | 잘못된 요청 값으로 처리 중 DB 에러가 발생했습니다. | A DB error occurred while processing with an invalid request value. |
| 500 | FAILED_SYSTEM_CHECK_TIME | 해당 은행 시스템 점검 시간입니다. 잠시 후 다시 시도해 주세요. | It is time to check the system. Please try again in a few minutes. |
| 500 | UNKNOWN_PAYMENT_ERROR | 결제에 실패했어요. 같은 문제가 반복된다면 은행이나 카드사로 문의해주세요. | Payment failed. If the same problem occurs, please contact your bank or credit card company. |
회원 탈퇴 처리
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 400 | INVALID_ACCESS_TOKEN | 유효하지 않은 `accessToken` 입니다. | Invalid `accessToken`. |
| 403 | EXPIRED_TOKEN | 만료된 토큰 값입니다. | The token had been expired. |
| 404 | NOT_FOUND_CUSTOMER | 유효한 고객 정보가 없습니다. | There is no valid customer information. |
| 500 | UNKNOWN_ERROR | 확인되지 않은 오류입니다. 잠시 후 다시 시도해주세요. | An unknown error occurred. Please try again in a few minutes. |
카드 프로모션 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 401 | UNAUTHORIZED_KEY | 인증되지 않은 시크릿 키 혹은 클라이언트 키 입니다. | Unauthorized secretKey or clientKey. |
계좌 프로모션 조회
| 상태 코드 | 에러 코드 | 한글 에러 메시지 | 영문 에러 메시지 |
|---|---|---|---|
| 404 | NOT_FOUND_MERCHANT | 존재하지 않는 상점 정보 입니다. | Not found merchant id |
구 모듈 에러
기존 전자결제 연동 모듈의 에러는 아래 링크에서 확인할 수 있습니다.