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:

  1. Beneficiary Id Code Validation
    • The Beneficiary Id Code must correspond to a valid customer identification code.
    • Error Message: "BeneficiaryIdCodeMustBeCustomer"
  2. 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"
  3. 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"
  4. 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"
  5. 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."
  6. 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.
  7. 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):

  1. 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"
  2. 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.
  3. 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.



Updated 10 Apr 2025
Did this page help you?
PREVIOUS
Wires
NEXT
Request and response codes
Docs powered by Archbee