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