--- title: Error codes: Wires slug: apis/payments/wires/error-codes-wires description: Cross River wire error codes for validation, authorization, and processing issues. docTags: createdAt: 2025-02-09T07:06:21.762Z --- ## Overview This page provides comprehensive error code information for the Wires API, including error codes, descriptions, and resolution guidance based on actual codebase analysis. ## Wires API response format ```json { "error": { "code": "2001", "message": "Payment not found", } } ``` *** ## Error codes by category ### Validation errors (1000-1006, 1200) Errors related to input validation and data format requirements. | Code | Description | Resolution | | -------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------ | | **1000** | Validation error - check error message for specifics | Resolve the validation error based on the error message | | **1001** | Config required | Configuration object is required in the request; include configuration details | | **1002** | InboundCountryWhitelist cannot add a country that is blacklisted | Remove country from blacklist before adding to whitelist | | **1003** | OutboundCountryWhitelist cannot add a country that is blacklisted | Remove country from blacklist before adding to whitelist | | **1004** | Originator.Identifier is not a valid account | Verify originator identifier is a valid account number | | **1005** | Originator.Identifier is not a valid routing number | Provide a valid routing number for originator identifier | | **1006** | Originator.Identifier is not a valid BIC | Provide a valid BIC (Bank Identifier Code) for originator identifier | | **1200** | State required | Provide a valid state in the request | ### Payment processing errors (2000-2116) Errors related to wire payment processing, validation, and lifecycle management. | Code | Description | Resolution | | -------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | | **2000** | General exception | General application error; check request parameters and payment state | | **2001** | Payment not found | Verify the payment ID is correct | | **2002** | Invalid payment status | Check current payment status; verify the requested operation is valid for the current status | | **2003** | Direction not inbound | Operation requires payment to be inbound; verify payment direction | | **2004** | Direction not outbound | Operation requires payment to be outbound; verify payment direction | | **2005** | Posting account cannot be changed as posting completed | Posting account cannot be changed after posting is complete | | **2006** | Acknowledgment required | Payment requires acknowledgment before processing | | **2007** | Originator account not found | Verify originator account number is correct and account exists | | **2008** | Origination not enabled for account | Enable wire origination in account configuration | | **2009** | Custom originator data not allowed for account | Account is not configured to allow custom originator data | | **2010** | Origination not allowed from a restricted account | Account has restrictions that prevent wire origination | | **2011** | Receiver routing number not found | Verify receiver routing number is correct and valid | | **2012** | Source wire not found | Verify source wire ID is correct; check if source wire exists | | **2013** | Source wire message unavailable | Source wire message cannot be retrieved | | **2014** | Service messages cannot be reversed | Reversal operations are not available for service messages | | **2015** | Payment type cannot be reversed | This payment type does not support reversal operations | | **2016** | Payment must be completed before it can be reversed | Only completed payments can be reversed; verify payment status | | **2017** | Only inbound payments can be reversed | Reversal operations only apply to inbound payments | | **2018** | Invalid source business function code | Business function code is not valid; provide a valid FedWire business function code | | **2019** | Payment must be completed before it can be responded to | Only completed payments can be responded to; verify payment status | | **2020** | Only inbound payments can be responded to | Response operations only apply to inbound payments | | **2021** | Original wire not found | Verify original wire ID is correct; check if original wire exists | | **2022** | Beneficiary account not found | Verify beneficiary account number is correct and account exists | | **2023** | Account not found | Verify the account number is correct; check if account exists in the system | | **2024** | Posting already completed | Posting has already been completed; cannot modify posting | | **2025** | Posting must be failed to attempt a retry | Only failed postings can be retried; verify posting status | | **2026** | Payment already acknowledged | Payment has already been acknowledged; cannot acknowledge again | | **2027** | International origination not enabled for account | Enable international wire origination in account configuration | | **2028** | Requested amount exceeded maximum threshold | Reduce payment amount to be within maximum limit for account | | **2029** | Drawdown credit account number does not match originator account number | Drawdown credit account must match originator account | | **2030** | Payment type cannot be investigated | This payment type does not support investigation operations | | **2031** | Payment type not transfer | Operation requires payment to be a transfer type | | **2032** | Drawdown credit account number is not a valid routing number | Provide a valid routing number for drawdown credit account | | **2033** | DrawdownDebitAccount.IdCode is missing or invalid | Provide a valid IdCode for drawdown debit account | | **2034** | DrawdownDebitAccount.Name is missing or invalid | Provide a valid name for drawdown debit account | | **2035** | Cannot respond to our own investigation requests | Cannot respond to investigations initiated by own institution | | **2036** | Name and Address are required when using IntermediaryFi | Include complete name and address for intermediary financial institution | | **2037** | Beneficiary name is required | Provide beneficiary name in the request | | **2038** | Beneficiary address is required | Provide complete beneficiary address | | **2039** | Beneficiary.Identifier is not a valid BIC | Provide a valid BIC (Bank Identifier Code) for beneficiary | | **2040** | BeneficiaryFi.Identifier is not a valid BIC | Provide a valid BIC for beneficiary financial institution | | **2041** | IntermediaryFi.Identifier is not a valid BIC | Provide a valid BIC for intermediary financial institution | | **2042** | Beneficiary.IdCode must be one of: 1,2,3,4,5,9,B,D | Provide a valid customer IdCode for beneficiary | | **2043** | Originator.Identifier is not a valid BIC | Provide a valid BIC for originator | | **2044** | At least one line of text is required for the requested type code | Include required text lines for the service message type | | **2045** | Invalid or missing investigation type code | Provide a valid investigation type code | | **2046** | Invalid investigation subtype code | Provide a valid investigation subtype code | | **2047** | Invalid or missing investigation reason code | Provide a valid investigation reason code | | **2048** | Invalid investigation reason subtype code | Provide a valid investigation reason subtype code | | **2049** | Narrative is required when reason code is NARR | Include narrative text when using NARR reason code | | **2051** | Source payment is not an investigation request | Source payment must be an investigation request type | | **2052** | Cannot investigate untransmitted payments | Payment must be transmitted before investigation can be initiated | | **2053** | Invalid or missing investigation status code | Provide a valid investigation status code | | **2054** | Invalid or missing investigation status reason code | Provide a valid investigation status reason code | | **2055** | Payment type not drawdown | Operation requires payment to be a drawdown type | | **2056** | Reason Code is missing or invalid | Provide a valid reason code from the allowed list | | **2057** | Source Payment type not Return Request | Source payment must be a return request type | | **2058** | Cancellation Reason Code is missing or invalid | Provide a valid cancellation reason code | | **2059** | Cancellation Additional Info is required | Include additional information for the cancellation | | **2060** | Amount must be equal or less than original payment amount | Reduce amount to match or be less than original payment | | **2061** | Originator address is required | Provide complete originator address | | **2062** | Originator.IdCode must be one of: 1,2,3,4,5,9,B,D | Provide a valid customer IdCode for originator | | **2063** | Originator.Name is required | Provide originator name in the request | | **2064** | BeneficiaryFi address is required | Provide complete beneficiary financial institution address | | **2065** | BeneficiaryFi.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for beneficiary FI | | **2066** | BeneficiaryFi.Name is required | Provide beneficiary financial institution name | | **2067** | BeneficiaryFi.Identifier is not a valid routing number | Provide a valid routing number for beneficiary financial institution | | **2068** | IntermediaryFi address is required | Provide complete intermediary financial institution address | | **2069** | IntermediaryFi.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for intermediary FI | | **2070** | IntermediaryFi.Identifier is not a valid routing number | Provide a valid routing number for intermediary financial institution | | **2071** | IntermediaryFi.Name is required | Provide intermediary financial institution name | | **2072** | Beneficiary.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for beneficiary | | **2073** | Beneficiary.Identifier is not a valid routing number | Provide a valid routing number for beneficiary | | **2074** | Originator.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for originator | | **2075** | Originator.Identifier is not a valid routing number | Provide a valid routing number for originator | | **2076** | Account or product configuration error | Verify account and product configuration settings | | **2077** | The Total Amount of all reversals must be equal or less than original payment amount | Combined reversal amounts exceed original payment amount | | **2078** | Sender routing number not found | Verify sender routing number is correct and valid | | **2079** | Beneficiary name or identifier required | Provide either beneficiary name or identifier | | **2080** | Originator name or identifier required | Provide either originator name or identifier | | **2081** | BeneficiaryFi name or identifier required | Provide either beneficiary FI name or identifier | | **2082** | IntermediaryFi name or identifier required | Provide either intermediary FI name or identifier | | **2083** | OriginatorFi address is required | Provide complete originator financial institution address | | **2084** | OriginatorFi.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for originator FI | | **2085** | OriginatorFi.Identifier is not a valid BIC | Provide a valid BIC for originator financial institution | | **2086** | OriginatorFi.Identifier is not a valid routing number | Provide a valid routing number for originator financial institution | | **2087** | OriginatorFi name or identifier required | Provide either originator FI name or identifier | | **2088** | OriginatorFi.Name is required | Provide originator financial institution name | | **2089** | InstructingFi address is required | Provide complete instructing financial institution address | | **2090** | InstructingFi.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for instructing FI | | **2091** | InstructingFi.Identifier is not a valid BIC | Provide a valid BIC for instructing financial institution | | **2092** | InstructingFi.Identifier is not a valid routing number | Provide a valid routing number for instructing financial institution | | **2093** | InstructingFi.Name is required | Provide instructing financial institution name | | **2094** | InstructingFi name or identifier required | Provide either instructing FI name or identifier | | **2095** | BeneficiaryFi not available with ISO format | BeneficiaryFi cannot be used with ISO format messages | | **2096** | IntermediaryFi not available with ISO format | IntermediaryFi cannot be used with ISO format messages | | **2097** | DrawdownDebitAccount address is required | Provide complete drawdown debit account address | | **2098** | DrawdownDebitAccount.IdCode must be one of: B,C,D,F,T,U | Provide a valid financial institution IdCode for drawdown debit account | | **2099** | DrawdownDebitAccount.Identifier is not a valid BIC | Provide a valid BIC for drawdown debit account | | **2100** | DrawdownDebitAccount.Identifier is not a valid routing number | Provide a valid routing number for drawdown debit account | | **2101** | DrawdownDebitAccount name or identifier required | Provide either drawdown debit account name or identifier | | **2102** | DrawdownDebitAccount.Name is required | Provide drawdown debit account name | | **2103** | IntermediaryFi and BeneficiaryFi cannot be identical | Use different institutions for intermediary and beneficiary FI | | **2104** | Unable to resend payment | Payment cannot be resent; check payment status and configuration | | **2105** | Combined service message line content cannot exceed 105 characters | Reduce service message line content to 105 characters or less | | **2106** | Combined service message line content cannot exceed 210 characters | Reduce service message line content to 210 characters or less | | **2107** | FedWire is currently closed. This request can only be sent during FedWire business hours | Wait for FedWire business hours to submit request | | **2108** | Payment must be completed before it can be return requested | Only completed payments can be return requested; verify payment status | | **2109** | Address1, Address2, and Address3 are no longer supported for origination. Please use PostalAddress fields instead | Use PostalAddress fields instead of legacy Address fields | | **2110** | PostalAddress AdrLine1 and AdrLine2 cannot exceed 35 characters | Limit address lines to 35 characters or less | | **2111** | investigationSubTypeCode must not be provided when using the specified investigationTypeCode | Remove investigationSubTypeCode for this investigation type | | **2112** | investigationSubTypeCode must be provided when using the specified investigationTypeCode | Include required investigationSubTypeCode | | **2113** | investigationReasonCode must be CONR when investigationTypeCode is CONR | Use CONR reason code for CONR investigation type | | **2114** | investigationReasonCode must be UTAP when investigationTypeCode is UTAP | Use UTAP reason code for UTAP investigation type | | **2115** | Cancellation Additional Info is not allowed with the specified cancellation reason code | Remove additional info for this cancellation reason code | | **2116** | Cannot claim payment was already returned because no related payment return was found | Verify payment return exists before claiming payment was returned | ### Submission errors (2200-2203) Errors related to wire submission processing. | Code | Description | Resolution | | -------- | ----------------------------- | ----------------------------------------------------------------------------------------------- | | **2200** | Invalid submission status | Check current submission status; verify the requested operation is valid for the current status | | **2201** | Submission must be pending | Operation requires submission to be in pending status | | **2202** | Submission must be processing | Operation requires submission to be in processing status | | **2203** | Submission must be created | Operation requires submission to be in created status | ### Distribution errors (2300-2309) Errors related to wire distribution lifecycle management. | Code | Description | Resolution | | -------- | ----------------------------------------------------- | ----------------------------------------------------------------- | | **2300** | Distribution must be pending | Operation requires distribution to be in pending status | | **2301** | Distribution must be verified | Operation requires distribution to be in verified status | | **2302** | Distribution must be released | Operation requires distribution to be in released status | | **2303** | Distribution must be generating | Operation requires distribution to be in generating status | | **2304** | Distribution must not be released | Operation requires distribution to not be released yet | | **2305** | Distribution already canceled | Distribution has already been canceled; cannot cancel again | | **2306** | No payments to distribute | Distribution must contain at least one payment | | **2307** | Distribution currently generating | Another distribution is currently generating; wait for completion | | **2308** | Distribution must be transmitted | Operation requires distribution to be in transmitted status | | **2309** | Distribution must be transmitted but not acknowledged | Distribution must be transmitted but not yet acknowledged | ### Hold errors (2400-2401) Errors related to wire payment hold management. | Code | Description | Resolution | | -------- | ---------------------- | -------------------------------------------------------------------- | | **2400** | Hold is not active | Hold must be in active status for this operation; verify hold status | | **2401** | Hold is not evaluating | Hold must be in evaluating status for this operation | ### Scan errors (2500-2503) Errors related to compliance scanning operations. | Code | Description | Resolution | | -------- | ------------------------------------------- | ---------------------------------------------------------------- | | **2500** | Scan already pending | A scan is already in progress; wait for current scan to complete | | **2501** | No scan lists are configured for account | Configure compliance scan lists for the account | | **2502** | Payment type must be a transfer | Scanning only applies to transfer payment types | | **2503** | Payment must be on hold to request a rescan | Payment must be in hold status before requesting a rescan | ### Posting record errors (2550) Errors related to posting record status. | Code | Description | Resolution | | -------- | ----------------------------- | -------------------------------------------------------------- | | **2550** | Invalid posting record status | Posting record status is not valid for the requested operation | ### Account configuration errors (2600-2613) Errors related to account and global configuration management. | Code | Description | Resolution | | -------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **2600** | This action requires dual control | Have a second authorized user approve the configuration change | | **2601** | Accounts must be unique | Each configuration field must use a different account number | | **2602** | Inbound Suspense Account not found | Configure a valid inbound suspense account | | **2603** | Outbound Suspense Account not found | Configure a valid outbound suspense account | | **2604** | Operator Account not found | Configure a valid operator account | | **2605** | Unposted Account not found | Configure a valid unposted account | | **2606** | Change not approved | Configuration change must be approved before applying | | **2607** | Change not pending | Operation requires configuration change to be in pending status | | **2608** | Global profile not found or is invalid | Verify global profile ID is correct and profile exists | | **2609** | Reversal Account not found | Configure a valid reversal account | | **2610** | Blocked Account not found | Configure a valid blocked account | | **2612** | Functionality is not supported when UseFedLineDirect is enabled | This feature is not available with FedLine Direct; disable FedLine Direct or use alternative method | | **2613** | Functionality is not supported when UseFedLineDirect is disabled | This feature requires FedLine Direct to be enabled | ### Whitelist errors (2650-2653) Errors related to wire whitelist management. | Code | Description | Resolution | | -------- | --------------------------------------------------- | -------------------------------------------------------------------------- | | **2650** | Account not found | Verify the account number is correct; check if account exists in whitelist | | **2651** | A whitelist entry with that criteria already exists | Whitelist entry already exists; cannot create duplicate | | **2652** | Change not approved | Whitelist change must be approved before applying | | **2653** | This action requires dual control | Have a second authorized user approve the whitelist change | ### Approval policy errors (2700-2703) Errors related to approval policy management. | Code | Description | Resolution | | -------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------- | | **2700** | Account not found | Verify the account number is correct; check if account exists in approval policy | | **2701** | An approval policy entry with that criteria already exists | Approval policy entry already exists; cannot create duplicate | | **2702** | Change not approved | Approval policy change must be approved before applying | | **2703** | This action requires dual control | Have a second authorized user approve the approval policy change | ### Integration errors (2750-2751) Errors related to FedLine Direct and FedWire integration. | Code | Description | Resolution | | -------- | -------------------------- | ------------------------------------------------------------ | | **2750** | FedLine Direct not enabled | Enable FedLine Direct in configuration to use this feature | | **2751** | FedWire is closed | FedWire is currently closed; wait for FedWire business hours | ### Automated drawdown response errors (2800-2803) Errors related to automated drawdown response configuration. | Code | Description | Resolution | | -------- | ------------------------------------------------------------ | ----------------------------------------------------------------- | | **2800** | Source payment must be an outbound drawdown response | Source payment must be an outbound drawdown response type | | **2801** | Product not found | Verify product ID is correct and product exists | | **2802** | Account not found | Verify the account number is correct; check if account exists | | **2803** | Request would create a duplicate automated drawdown response | An automated drawdown response with these criteria already exists | ### Security/permission errors (3000-3006, 3200) Errors related to user permissions and security. | Code | Description | Resolution | | -------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | **3000** | General exception | General security error; verify user permissions and authorization | | **3001** | Origination payment amount exceeds user permissions | Payment amount exceeds user's origination dollar limit; reduce amount or request approval from higher authority | | **3002** | Clearing hold exceeds user permissions for payment amount | Payment amount exceeds user's hold clearance dollar limit; request approval from higher authority | | **3003** | Posting flags not allowed for user | User does not have permission to set posting flags; contact administrator | | **3004** | User not authorized to reject inbound wires | User lacks permission to reject inbound wires; contact administrator for access | | **3005** | Distribution max wire amount exceeds user permissions | Distribution amount exceeds user's maximum distribution dollar limit | | **3006** | User not authorized to clear this type of hold | User lacks permission to clear this hold type; request approval from authorized user | | **3200** | Access denied | User lacks permission to access configuration; verify user has appropriate role and permissions |