Error codes: Wires

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 { "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