API Suite - May 2022 Release Notes Summary

Summary of changes for the API Suite functional release for May 2022

SWIFT BIC Length Validation
When submitting a payment where the payment method is WIRE the following fields will be validated.
1. bankAccount.bankCode
2. thirdPartyRemitter.bankAccount.bankCode
3. originatingFI.bankCode

New Validation Rules
1. The Swift code length must be only 8 or 11 characters

New Error Code

If the above conditions are not met, then the payment will not be accepted and display error code: 1226 Invalid SWIFT code format.

Country Code Validations
The following payment fields can now contain upper and lower case characters.

  1. beneficiary.countryCode
  2. bankAccount.countryCode
  3. bankAccount.bankCode
  4. thirdPartyRemitter.countryCode
  5. thirdPartyRemitter.bankAccount.bankCode
  6. originatingFI.countryCode
  7. originatingFI.bankCode

Third Party Remitter and Originating FI Validations
When submitting a payment with Third Party Remitter or Originating FI data and the payment is not accepted due to blank or Null fields, the error codes displayed have been updated to provide more details. The following are the fields and the new error codes:

Payment Field NameError Code
originatingFI.address.AddressLine11003:originatingFI.address.AddressLine1
originatingFI.address.City1003:originatingFI.address.City
originatingFI.address.CountryCode1003:originatingFI.address.CountryCode
originatingFI address.StateOrProvince1003:originatingFI address.StateOrProvince
originatingFI.address.ZipOrPostalCode1003:originatingFI.address.ZipOrPostalCode
thirdPartyRemitter.address.AddressLine11003:thirdPartyRemitter.address.AddressLine1
thirdPartyRemitter.address.City1003:thirdPartyRemitter.address.City
thirdPartyRemitter.address.CountryCode1003:thirdPartyRemitter.address.CountryCode
thirdPartyRemitter.address.StateOrProvince1003:thirdPartyRemitter.address.StateOrProvince
thirdPartyRemitter.address.ZipOrPostalCode1003:thirdPartyRemitter.address.ZipOrPostalCode
thirdPartyRemitter.id1003:thirdPartyRemitter.id