Bank rails
Wires
IMPORTANT: Wires API update
6min
as part of the industry wide transition to iso 20022, fedwire will adopt this new messaging standard on july 14, 2025 this migration enhances financial messaging, improves data quality, and increases efficiency across payment networks new api validations and default values as part of our wires iso 20022 implementation, we are introducing new api validations across different wire message types these validations ensure compliance, ensure data accuracy, and improve processing accuracy below is a breakdown of the new validations by message type, along with default values applied if certain fields are not populated 1\ originate customer transfers (pacs 009) endpoint post /wires/v1/payments valid customer identification codes the following customer identification codes are recognized for processing customer transfers passport number "1" tax identification number (tin) "2" driver’s license number "3" alien registration number "4" corporate identification number "5" other identification "9" swift bank identifier code (bic) "b" demand deposit account number "d" to ensure compliance and accuracy, the following validation rules and default values will be enforced when originating customer transfers beneficiary id code validation the beneficiary id code must correspond to a valid customer identification code error message "beneficiaryidcodemustbecustomer" beneficiary name requirement if the beneficiary id code is "b" (swift bic code) and the beneficiary name is null or empty , the request will be rejected error message "beneficiarynamerequired" beneficiary address requirement if the beneficiary id code is "b" (swift bic code) and address1 is null or empty , the request will be rejected error message "beneficiaryaddressrequired" swift bic format validation if the beneficiary, beneficiary fi, or intermediary fi has an id code of "b" (swift bic code) and the identifier is not in a valid bic format , the request will be rejected error message "beneficiaryidentifierinvalidbic" intermediary fi validation if an intermediary fi is provided, additional validation applies if the id code is a fed routing number , the identifier must be a valid fed participant error message "intermediaryfi identifier is invalid " if the id code is not a fed routing number, the intermediary fi name and address must be provided error message "intermediaryfinameandaddressrequired " beneficiary fi information if not provided , this information will be derived from the receiver routing number defaults to id code defaults to fed routing number ("f") identifier defaults to the participant's routing number name defaults to participant’s customer name address1 defaults to participant’s city and state intermediary fi information if intermediary fi is using a fed routing number ("f"), the system will fetch the participant’s details based on the receiver routing number automatically populate the name and address if intermediary fi is not using a fed routing number , the name and address must be manually provided 2\ originate drawdown requests (pain 013) no new validations 3\ originate drawdown responses (pain 014) endpoint post /wires/v1/payments/{id}/drawdown responses to ensure compliance and accuracy, the following validation rules and default values will be enforced when originating drawdown responses (drws) if the originator id code is "b" (swift bic code) and the identifier does not follow a valid bic format, the request will be rejected error message "originatoridentifierinvalidbic" beneficiary fi information this information will be derived from the sender routing number of the drawdown request (drc) defaults to id code defaults to fed routing number ("f") identifier defaults to the participant's routing number name defaults to participant’s customer name address1 defaults to participant’s city and state originator fi information this information will be derived from the receiver routing number of the drawdown request (drc) defaults to id code defaults to fed routing number ("f") identifier defaults to the participant's routing number name defaults to participant’s customer name address1 defaults to participant’s city and state 4\ reverse payment (pacs 004) no new validations