Error codes: checks

overview this page provides comprehensive error code information for the checks api, including error codes, descriptions, and resolution guidance based on actual codebase analysis error response format { "errors" \[ { "code" 2301, "message" "deposits not allowed for account type" } ] } error codes by category payment processing errors (2000 2034) errors related to check payment processing, status management, and validation code description resolution 2000 general exception review error details contact support if the issue persists 2001 invalid payment status check current payment status verify the requested operation is valid for the current status 2002 invalid posting status payment posting status does not allow the requested operation verify posting status 2003 payment cannot be canceled payment status does not allow cancellation verify payment is in cancellable status 2004 account not found verify the account number is correct check if account exists in the system 2005 payment must be outbound operation requires payment to be outbound verify payment direction 2006 payment must be inbound operation requires payment to be inbound verify payment direction 2007 payment must be an inbound origination operation requires an inbound origination payment type 2008 payment must be status completed or rejected to be corrected payment correction requires completed or rejected status verify payment status 2009 invalid change code change code is not valid provide a valid change code 2010 payment must be an inbound return operation requires an inbound return payment type 2011 payment must be an origination operation requires an origination payment type 2012 payment must be status completed or rejected to be returned payment return requires completed or rejected status verify payment status 2013 payment must be status completed or rejected to be dishonored payment dishonor requires completed or rejected status verify payment status 2014 invalid return code return code is not valid; provide a valid check return code 2015 invalid dishonored return code dishonored return code is not valid provide a valid dishonored return code 2016 original payment not found verify original payment id is correct check if original payment exists 2017 cannot link to same payment id linked payment id must be different from current payment id 2018 payment type must be return or notification of change operation requires payment to be a return or noc type 2019 original payment must be completed linked original payment must be in completed status 2020 payment must be on hold to request a rescan payment must be in hold status before requesting a rescan 2021 no scan lists are configured for account configure scan lists for the account before requesting scans 2022 scan already pending a scan is already in progress wait for current scan to complete 2023 previous payment not found verify previous payment id is correct check if previous payment exists 2024 previous payment must be a completed outbound origination previous payment must be an outbound origination in completed status 2025 receiver account not found verify receiver account number is correct check if account exists 2026 active holds found payment has active holds resolve or release holds before processing 2027 posting account cannot be changed due to current payment status payment status does not allow posting account changes 2028 posting status must be pending or failed to change posting account posting account can only be changed when posting is pending or failed 2029 posting status must be failed to attempt a retry only failed postings can be retried verify posting status 2030 originator profile address missing or invalid provide complete originator address information verify address format 2031 payment image data not available check image data is not available verify image upload was successful 2032 invalid front image format front check image format is invalid provide image in base64 encoded format 2033 invalid back image format back check image format is invalid provide image in base64 encoded format 2034 payment amount cannot be changed payment amount is locked and cannot be modified batch errors (2200 2202) errors related to check batch processing and authorization code description resolution 2200 batch not authorizing batch must be in authorizing status for this operation verify batch status 2201 batch requires one or more payments batch must contain at least one payment add payments to batch 2202 no filters were found on the request include filter parameters in the request specify search criteria configuration errors (2300 2331) errors related to account, product, and global configuration management code description resolution 2300 no active configuration found for account account must have an active configuration create or activate account configuration 2301 deposits not allowed for account type account type does not support check deposits verify account configuration 2306 max payment amount exceeded payment amount exceeds maximum limit reduce amount or increase limit 2309 origination not allowed from a restricted account account has restrictions that prevent check origination 2310 account config change not approved account configuration change must be approved before applying 2311 account config change not pending operation requires account change to be in pending status 2312 account config change approval requires dual control have a second authorized user approve the account configuration change 2313 account configuration not found or is invalid verify account configuration id is correct and configuration exists 2314 global profile not found or is invalid verify global profile id is correct and profile exists 2315 global profile change not approved global configuration change must be approved before applying 2316 global profile change not pending operation requires global profile change to be in pending status 2317 product change not pending operation requires product change to be in pending status 2318 product change not approved product configuration change must be approved before applying 2319 global config change approval requires dual control have a second authorized user approve the global configuration change 2320 global config required include global configuration object in the request 2321 global config accounts must be unique use different account numbers for each global configuration field 2323 inbound suspense account not found configure a valid inbound suspense account 2324 outbound suspense account not found configure a valid outbound suspense account 2325 return account not found configure a valid return account 2326 operator account not found configure a valid operator account 2327 unposted account not found configure a valid unposted account 2328 product config change approval requires dual control have a second authorized user approve the product configuration change 2329 account config required include account configuration object in the request 2330 product config required include product configuration object in the request 2331 printing account not found configure a valid printing account distribution errors (2400 2418) errors related to check distribution lifecycle management code description resolution 2400 distribution must be generating operation requires distribution to be in generating status 2401 distribution already canceled distribution has already been canceled; cannot cancel again 2402 distribution must be pending operation requires distribution to be in pending status 2403 distribution must be on hold operation requires distribution to be in hold status 2404 distribution must be verified operation requires distribution to be in verified status 2405 distribution must be released operation requires distribution to be in released status 2406 distribution must not be released operation requires distribution to not be released yet 2407 distribution must be transmitted operation requires distribution to be in transmitted status 2408 distribution must be acknowledged operation requires distribution to be in acknowledged status 2409 distribution must be processing operation requires distribution to be in processing status 2410 distribution must have been previously transmitted distribution must have been transmitted at least once 2411 distribution release requires dual control have a second authorized user approve the distribution release 2412 a distribution is currently generating another distribution is currently generating wait for completion 2413 no payments to distribute distribution must contain at least one payment 2414 distribution is currently processing and can no longer be acknowledged distribution is processing acknowledgment window has closed 2415 distribution is currently complete and can no longer be acknowledged distribution is complete acknowledgment is no longer available 2416 cannot verify distribution with exceeded limits distribution exceeds configured limits review and adjust limits or distribution 2417 no filters were found on the request include filter parameters in the request specify search criteria 2418 only one distribution per minute is allowed wait at least one minute before creating another distribution submission errors (2500 2501) errors related to check submission processing code description resolution 2500 submission import count cannot exceed total payment count import count is invalid ensure it does not exceed total payment count 2501 submission process count cannot exceed total payment count process count is invalid ensure it does not exceed total payment count hold errors (2600 2603) errors related to check payment hold management code description resolution 2600 hold is not active hold must be in active status for this operation verify hold status 2601 hold payment not found verify hold payment id is correct check if hold payment exists 2602 no filters were found on the request include filter parameters in the request specify search criteria 2603 this action requires dual control have a second authorized user approve the hold operation security errors (3000 3002) security related errors including permissions and access control code description resolution 3000 general exception review error details contact support if the issue persists 3001 flags not allowed user does not have permission to set flags contact administrator 3002 clearing hold exceeds user permissions for payment amount payment amount exceeds user's hold clearance dollar limit request approval from higher authority configuration access errors (3200) configuration specific access control errors code description resolution 3200 access denied user lacks permission to access configuration verify user has appropriate role and permissions