가이드
결제 에러 응답코드

결제 에러 응답코드

  • 토스페이 에러코드는 예고 없이 업데이트 될 수 있습니다. 추가되더라도 오류가 발생하지 않도록 연동 부탁드립니다.
  • 토스에서는 한 가지 에러코드에 상황별로 다른 오류 메시지를 전달합니다.
💡
여러 상황이 발생할 수 있으니 되도록이면 전달되는 오류 메시지 그대로를 처리해주세요.

공통

응답 코드 (errorCode)사유 (msg)
COMMON_SYSTEM_ERROR시스템 오류로 인해 통신이 원활하지 않습니다. 문제가 계속되면 토스 고객센터로 문의해주세요. (1599-4905)
COMMON_INVALID_PARAMETER요청한 값이 바르지 않습니다.
COMMON_PAY_ERROR문제가 발생하였습니다.
COMMON_NOT_ENOUGH_CASH충전계좌의 잔액이 부족하여 토스머니 충전이 불가합니다.
COMMON_EXCEED_LIMIT한도를 초과하였습니다.
COMMON_ASSET_GET_ACCOUNT_ERROR계좌 정보 조회에 실패하였습니다.
COMMON_REFUND_ERROR환불이 불가능한 상태입니다.
REFUND_REFUND_NO_DUPLICATE이미 환불 처리된 refundNo입니다.
PAYMENT_DUPLICATION_ORDER_NO중복된 주문번호입니다.
PAYMENT_EXISTING_PAYMENT이미 존재하는 결제입니다.
TRANSACTION_PENDING_ERROR조금 전 신청하신 결제가 아직 진행 중입니다. 잠시 후 다시 시도해 주세요. 10분 이상 지속되면 토스팀에 문의해 주세요. (1599-4905)
INVALID_ACCOUNT_STATUS계좌 상태를 확인해 주세요.
FRAUD_DETECTION_SYSTEM_ERRORFDS에 의해 금융거래가 차단된 상태입니다.
USER_STATUS_ERROR결제 진행이 불가한 사용자입니다.
REFUND_ALREADY_REFUNDED이미 전액 환불 처리된 거래 건입니다.
TRANSACTION_NOT_COMPLETE거래가 완료되지 않았습니다.
TRANSACTION_NOT_FOUND존재하지 않는 거래내역입니다.
INACTIVE_USER비활성 처리된 사용자입니다.
AUTO_CHARGE_NOT_YET_REGISTER_ACCOUNT충전계좌가 등록되지 않았습니다.

USER (사용자)

응답 코드 (errorCode)사유 (msg)
PAY_UNAUTHORIZED결제 요청자와 토스의 계정이 일치해야만 결제가 가능합니다. 확인 후 다시 시도해 주세요.
TOSS_APP_UPDATE_IS_REQUIRED결제를 진행하려면 최신 버전의 토스 앱을 이용해 주세요.
PAY_CANCEL_ITS_NOT_CANCELABLE_STATUS결제를 취소할 수 없습니다. 잠시 후 다시 시도해 주세요. 문제가 계속되면 토스 고객센터로 문의해 주세요. (1599-4905)
COUPON_ASSIGN_FAIL쿠폰 발급에 실패하였습니다.
DISCOUNT_CLOSED할인 혜택이 마감되었습니다.
USER_DISCOUNT_CLOSED1인당 할인 횟수를 초과하였습니다.
DISCOUNT_NEED_ISSUE쿠폰을 발급받아 주세요.
DISCOUNT_ALREADY_ISSUED쿠폰이 이미 발급되었습니다.
AVAILABLE_ONLY_TOSS_MONEY_UNDER_MIN_AMT%s원 미만 금액은 %s 카드 결제가 불가합니다.
AUTO_PAY_TERM_INACTIVE_FAIL약관 철회에 실패하였습니다.
AGE_POLICY_ERROR%d세 미만인 경우 토스 %s 서비스를 이용하실 수 없습니다.
PAY_FRAUD_DETECTED일시적으로 토스 서비스를 이용할 수 없습니다. 문제가 계속되면 토스 고객센터로 문의해 주세요. (1599-4905)
BLOCKED_THE_USE_OF_POINT법원 압류 판결로 인해 토스 포인트를 쓸 수 없습니다. 궁금한 점은 토스 고객센터(1599-4905)로 문의해 주세요.

카드

응답 코드 (errorCode)사유 (msg)
CARD_SYSTEM_ERROR카드사 시스템 점검 중입니다. 잠시 후 다시 시도해 주세요.
CARD_BANK_SYSTEM_ERROR카드사 거래은행 시스템 점검 중입니다. 잠시 후 다시 시도해 주세요
CARD_NOT_AVAILABLE_SHOP해당 카드로 결제가 불가합니다. 다른 결제수단으로 시도하거나 토스 고객센터로 문의해 주세요. (1599-4905)
CARD_NOT_AVAILABLE도난/분실/거래 정지 카드로 승인이 거절되었습니다.
CARD_EXCEED_LIMIT사용 한도 초과로 승인이 거절되었습니다.
CARD_NOT_ENOUGH_BALANCE잔고 부족으로 승인이 거절되었습니다.
CARD_SPREADOUT_ERROR할부 사용이 불가능한 카드로 승인이 거절되었습니다.
CARD_MIN_AMOUNT_ERROR금액 오류 (100원 또는 1달러 미만 신용카드 승인 불가)
CARD_MIN_AMOUNT_FOR_SPREADOUT_ERROR할부 결제는 결제금액이 50,000원 이상이어야 합니다. 일시불로 결제해 주세요.

BNPL (후불결제)

응답 코드 (errorCode)사유 (msg)
BNPL_INVALID_REQUEST잘못된 요청입니다.
BNPL_NOT_EXIST_USER존재하지 않는 BNPL 사용자입니다.
BNPL_EXCEED_PAYABLE_AMOUNTBNPL 한도가 초과되었습니다.
BNPL_ALREADY_COMPLETED_REQUEST이미 처리된 요청입니다.
BNPL_IN_PROGRESS_REQUEST이미 처리 중인 요청입니다.
BNPL_NOT_FOUND_PAYMENT존재하지 않는 결제건입니다.
BNPL_ALREADY_COMPLETED_REFUND환불할 수 없는 결제 건입니다.
NOT_SET_BNPL_PAYMENT_ACCOUNT후불결제 진행을 위해 납부계좌 설정이 필요합니다.

매출전표

응답 코드 (errorCode)사유 (msg)
SALES_CHECK_NOT_FOUND_USER매출전표 조회를 위한 사용자 정보가 존재하지 않습니다.
SALES_CHECK_USER_AUTH_FAIL매출전표 조회를 위한 사용자 정보 인증에 실패하였습니다.
SALES_CHECK_USER_AUTH_DECRYPT_FAIL매출전표 조회를 위한 사용자 정보 복호화에 실패하였습니다.
SALES_CHECK_CARD_ONLY카드결제 건에 대해서만 매출전표 조회가 가능합니다.

자동결제

응답 코드(errorCode)사유(msg)
NOT_SUPPORTED_BILLING_KEY_SHOP자동결제를 지원하지 않는 상점입니다. support-pay@toss.im으로 문의해주세요.
BILLING_KEY_ALREADY_ACTIVATED이미 활성화된 자동결제가 존재합니다.
BILLING_KEY_REGISTRATION_CANCELLED자동결제 등록이 취소되었습니다.
BILLING_KEY_UNREGISTERED_BY_CANCEL이미 자동결제 등록이 취소되어 더 이상 진행할 수 없습니다. 처음부터 다시 진행해주세요.
BILLING_KEY_AUTH_ERROR해당 정기결제 건은 인증 가능한 상태가 아닙니다.
BILLING_KEY_EXPIRED_AUTH_TIME인증 가능 시간이 만료되었습니다.
BILLING_KEY_USER_CI_ERROR토스에 등록된 사용자 정보가 일치하지 않습니다.
BILLING_KEY_REMOVE_NOT_ALLOWED_SHOP자동결제 삭제가 허용된 가맹점이 아닙니다.
ALREADY_EXISTED_AUTH이미 요청된 인증이 존재합니다.
NOT_SUPPORTED_PAYMENT_METHOD자동결제에서 지원하지 않는 결제 수단입니다.
EXIST_ACTIVATED_BILLING_KEY_USING_THIS_METHOD자동결제가 등록된 결제 수단은 삭제할 수 없습니다. 자동결제를 해지해주세요.
COMMON_BILLING_KEY_NOT_FOUND자동결제 정보를 찾을 수 없습니다.
COMMON_NOT_ENOUGH_CASH자동충전 금액을 늘리거나 토스머니에 잔액을 충전해주세요.
COMMON_INVALID_PARAMETER요청한 값이 바르지 않습니다.
COMMON_SYSTEM_ERROR이미 처리가 진행 중입니다. 잠시 후 다시 시도해주세요.
COMMON_INVALID_API_KEY바르지 않은 API key입니다.
CORE_USER_ERROR사용자가 존재하지 않습니다.

리셀러

응답 코드 (errorCode)사유 (msg)
COMMON_PAY_RESELLER_ERROR리셀러 결제 처리 중 에러가 발생했습니다.
RESELLER_ONLY_CARD_PAYMENT카드 결제가 아닙니다.
RESELLER_CALLBACK_PROCESS_ERROR리셀러 콜백 처리 중 에러가 발생했습니다.
NOT_APPROVED_CARD_PAYMENT카드로 사용자 승인된 결제가 아닙니다.
PAY_CARD_AUTH_REQUEST_ERROR카드 인증 요청에 실패하였습니다.
NOT_SUPPORTED_RESELLER_SHOP리셀러로 지정된 가맹점이 아닙니다.

기타

응답 코드 (errorCode)사유 (msg)
PAYMENT_SHOP_STATE_NOT_NORMAL결제 불가 가맹점입니다. 가맹점 고객센터로 문의해 주세요.
PAYMENT_SHOP_STATE_CANNOT_REFUND결제 불가 가맹점입니다. 가맹점 고객센터로 문의해 주세요. (사고 신고)
COMMON_INVALID_API_KEY바르지 않은 API key입니다.
NOT_INTERNAL_SHOP내부 가맹점이 아닙니다.
COMMON_BREAK_TIME_OF_BANK지금은 은행 점검 시간입니다. 점검이 끝난 후 사용해 주세요.
COMMON_UNAUTHORIZEDUnauthorized Access
REFUND_EXCEED_DAILY환불 금액이 상점의 일일 환불 한도보다 클 수 없습니다.
EXECUTE_PAY_NOT_APPROVED아직 구매자가 결제를 승인하지 않았습니다.
PAUSE_USER일시정지 사용자입니다.
COMMON_TIMEOUT처리 중 지연이 발생하였습니다. 다시 시도해 주세요.
COMMON_THROTTLED결제 요청이 많아 서비스 이용이 원활하지 않습니다. 잠시 후에 다시 시도해 주세요.
COMMON_ITS_NOT_ABLE_TO_CHANGE_STATUS요청 가능한 상태가 아닙니다.
ESCROW_IMPOSSIBLE_STATUS에스크로 상태 변경이 불가능합니다.

현금영수증

응답 코드 (errorCode)사유 (msg)
CASH_RECEIPT_JOIN_MEMBER_FAIL현금영수증 연동회원 신규가입이 실패하였습니다.
CASH_RECEIPT_REGIST_ISSUE_FAIL현금영수증을 발행하지 못했습니다.
CASH_RECEIPT_ALREADY_ISSUE_FAIL현금영수증이 이미 발행 되었습니다.
CASH_RECEIPT_ALREADY_CANCEL_FAIL현금영수증이 이미 취소 되었습니다.
CASH_RECEIPT_ISSUE_IN_PROGRESS현금영수증 발행 진행 중 입니다.
CASH_RECEIPT_CANCEL_ISSUE_FAIL현금영수증 발행 취소를 하지 못했습니다.
CASH_RECEIPT_REVOKE_REGIST_ISSUE_FAIL취소 현금영수증을 발행하지 못했습니다.
CASH_RECEIPT_GET_INFO_FAIL현금영수증 정보 확인에 실패하였습니다.
CASH_RECEIPT_NOT_EXIST발급된 현금영수증이 존재하지 않습니다.
CASH_RECEIPT_GET_POPUP_URI_FAIL현금영수증 조회 링크를 가져오지 못했습니다.
CASH_RECEIPT_UNKNOWN_STATUS_CODE존재하지 않는 현금영수증 상태코드 입니다.
CASH_RECEIPT_CANNOT_ISSUE_CARD카드 결제는 현금영수증을 발행할 수 없습니다.
CASH_RECEIPT_MAINTENANCE_TIME현금 영수증 서비스 점검 시간입니다.
CASH_RECEIPT_INVALID_USER_INFO잘못된 식별번호입니다.
CASH_RECEIPT_INVALID_PARAMETER요청 값이 잘못되었습니다.
NOT_SUPPORTED_CASH_RECEIPT_AGENCY지원하지 않는 현금영수증 발행처입니다.
신용카드 매출전표토스 은행 코드 리스트