에러 코드
목차

Version 2

새로 나온

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

결제위젯 에러

코드메시지
AGREEMENT_WIDGET_ALREADY_RENDERED하나의 약관 위젯만을 사용할 수 있어요.
BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.
CUSTOM_PAYMENT_METHOD_UNABLE_TO_PAY커스텀 결제수단으로 결제할 수 없습니다.
EXCEED_DEPOSIT_AMOUNT_LIMIT가상계좌 입금 제한 금액을 초과했어요. 다른 결제수단을 이용해주세요.
EXCEED_MAX_DUE_DATE가상 계좌의 최대 유효만료 기간을 초과했습니다.
INCORRECT_FAIL_URL_FORMAT잘못된 failUrl 입니다.
INCORRECT_SUCCESS_URL_FORMAT잘못된 successUrl 입니다.
INVALID_AMOUNT_CURRENCY잘못된 통화 값입니다.
INVALID_AMOUNT_VALUE결제금액이 올바르지 않습니다.
INVALID_PARAMETER콜백 함수가 올바르지 않습니다.
INVALID_CLIENT_KEYClientKey 형태가 올바르지 않습니다.
INVALID_CUSTOMER_KEY고객키는 영문 대소문자, 숫자, 특수문자 -, _, =, ., @로 2자 이상 255자 이하여야 합니다.
INVALID_PARAMETER허용하지 않는 이벤트입니다.
INVALID_METHOD_TRANSACTION이미 다른 요청을 수행하고 있어요.
INVALID_PARAMETERS필수 파라미터를 누락하거나, 정의되지 않은 파라미터를 추가하거나, 파라미터의 타입이 올바르지 않을 때 발생합니다.
INVALID_SELECTORselector에 해당하는 HTML 요소를 찾을 수 없습니다. selector 값을 다시 확인해주세요.
INVALID_VARIANT_KEYvariantKey 에 해당하는 위젯을 찾을 수 없습니다. variantKey 값을 다시 확인해주세요.
NEED_AGREEMENT_WITH_REQUIRED_TERMS필수 약관에 동의해주세요.
NEED_CARD_PAYMENT_DETAIL카드 결제 정보를 선택해주세요.
NEED_REFUND_ACCOUNT_DETAIL환불계좌 정보를 모두 입력해주세요.
NOT_SELECTED_PAYMENT_METHOD결제수단이 아직 선택되지 않았어요. 결제수단을 선택해 주세요.
NOT_SETUP_AMOUNT결제금액이 설정되지 않았습니다. setAmount를 호출해주세요.
NOT_SUPPORTED_PROMISEPromise 방식을 지원하지 않습니다. successUrl, failUrl을 사용해주세요.
PAYMENT_METHODS_WIDGET_ALREADY_RENDERED하나의 결제수단 위젯만을 사용할 수 있어요.
PROVIDER_STATUS_UNHEALTHY결제 기관(카드사, 은행, 국세청 등) 오류입니다. 다른 결제수단을 선택해 주세요.
UNKNOWN알 수 없는 에러가 발생했습니다.
UNSUPPORTED_TEST_PHASE_PAYMENT_METHOD테스트 환경을 지원하지 않는 결제수단입니다.
USER_CANCEL취소되었습니다.
V1_METHOD_NOT_SUPPORTED해당 API 는 v1 에서만 제공됩니다.
WIDGETS_SDK_INITIALIZE_CONFLICTwidgets는 payment 또는 brandpay와 같이 사용할 수 없습니다.

브랜드페이 에러

코드메시지
BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.
BRANDPAY_SDK_INITIALIZE_CONFLICTbrandpay와 widgets는 같이 사용할 수 없습니다.
INCORRECT_FAIL_URL_FORMAT잘못된 failUrl 입니다.
INCORRECT_SUCCESS_URL_FORMAT잘못된 successUrl 입니다.
INVALID_AMOUNT_VALUE결제금액이 올바르지 않습니다.
INVALID_CLIENT_KEYClientKey 형태가 올바르지 않습니다.
INVALID_CUSTOMER_KEY고객키는 영문 대소문자, 숫자, 특수문자 -, _, =, ., @로 2자 이상 255자 이하여야 합니다.
INVALID_METHOD_TRANSACTION이미 다른 요청을 수행하고 있어요.
INVALID_PARAMETERS필수 파라미터를 누락하거나, 정의되지 않은 파라미터를 추가하거나, 파라미터의 타입이 올바르지 않을 때 발생합니다.
NEED_AGREEMENT_WITH_TERMS이용약관 동의가 필요합니다.
NEED_MERCHANT_ONE_TOUCH_SETTING원터치결제 사용을 위해서는 가맹점 설정이 필요합니다.
UNKNOWN알 수 없는 에러가 발생했습니다.
USER_CANCEL취소되었습니다.
V1_METHOD_NOT_SUPPORTED해당 API 는 v1 에서만 제공됩니다.
NOT_REGISTERED_REDIRECT_URL리다이렉트 URL이 등록되지 않았습니다. 개발정보 페이지에서 등록해주세요. https://developers.tosspayments.com/my/brandpay

결제창 에러

코드메시지
BELOW_ZERO_AMOUNT금액은 0보다 커야 합니다.
INCORRECT_FAIL_URL_FORMAT잘못된 failUrl 입니다.
INCORRECT_SUCCESS_URL_FORMAT잘못된 successUrl 입니다.
INVALID_AMOUNT_CURRENCY잘못된 통화 값입니다.
INVALID_AMOUNT_VALUE결제금액이 올바르지 않습니다.
INVALID_CLIENT_KEYClientKey 형태가 올바르지 않습니다.
INVALID_CUSTOMER_KEY고객키는 영문 대소문자, 숫자, 특수문자 -, _, =, ., @로 2자 이상 255자 이하여야 합니다.
INVALID_METHOD_TRANSACTION이미 다른 요청을 수행하고 있어요.
INVALID_PARAMETERS필수 파라미터를 누락하거나, 정의되지 않은 파라미터를 추가하거나, 파라미터의 타입이 올바르지 않을 때 발생합니다.
NOT_SUPPORTED_METHOD지원되지 않는 결제수단입니다.
NOT_SUPPORTED_PROMISEPromise 방식을 지원하지 않습니다. successUrl, failUrl을 사용해주세요.
PAYMENT_SDK_INITIALIZE_CONFLICTpayment와 widgets는 같이 사용할 수 없습니다.
UNKNOWN알 수 없는 에러가 발생했습니다.
USER_CANCEL취소되었습니다.
V1_METHOD_NOT_SUPPORTED해당 API 는 v1 에서만 제공됩니다.
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기