Error codes: ACH

overview this page provides comprehensive error code information for the ach api, including error codes, descriptions, and resolution guidance based on actual codebase analysis error response format { "errors" \[ { "code" 1000, "message" "receiver routingnumber is missing or invalid" } ] } error codes by category validation errors (1000 1001) general validation errors for ach operations error code description resolution 1000 general exception general validation error; check request parameters and contact support if issue persists 1001 payment required payment object is required in the request; include payment details payment processing errors (2000 2030) errors related to ach payment processing, status management, and validation error code description resolution 2000 general exception general application error; check request parameters and contact support if 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 nacha 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 nacha return code 2015 invalid dishonored return code dishonored return code is not valid; provide a valid nacha 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 batch errors (2200 2202) errors related to ach batch processing and authorization error 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 payment 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