SWIFT Code Validation on Recipient Creation
2 months ago by Jason Mittler
Starting 23 July 2026, we will validate that the country code within a SWIFT/BIC code matches the declared bank country when creating recipients.
What's changing
For bank accounts where network is SWIFT, the country code embedded in provider.networkIdentifier (characters 5–6, e.g. the US in BOFAUS3N) must match the value provided in provider.country. Mismatches are rejected with a 400 error at recipient creation.
This applies to both the Create Payment endpoint (when passing a new receivingParty inline) and the Create Receiving Party endpoint.
Why
Recipients created with a mismatched SWIFT code and bank country fail at the payment stage, leading to delayed or stuck payments. Validating at creation catches these errors immediately.