Struct Field54A

Source
pub struct Field54A {
    pub account_line_indicator: Option<String>,
    pub account_number: Option<String>,
    pub bic: BIC,
}
Expand description

§Field 54A: Receiver’s Correspondent

§Overview

Field 54A identifies the receiver’s correspondent institution in SWIFT payment messages. This field specifies the financial institution that acts as a correspondent for the message receiver, facilitating the payment routing and settlement process on the receiving side. The correspondent relationship is essential for cross-border payments and international correspondent banking arrangements.

§Format Specification

Format: [/34x]4!a2!a2!c[3!c]

  • 34x: Optional account number (up to 34 characters)
  • 4!a2!a2!c[3!c]: BIC code (8 or 11 characters)
    • 4!a: Bank code (4 alphabetic characters)
    • 2!a: Country code (2 alphabetic characters, ISO 3166-1)
    • 2!c: Location code (2 alphanumeric characters)
    • 3!c: Optional branch code (3 alphanumeric characters)

§Structure

/1234567890123456789012345678901234
DEUTDEFF500
│       │││
│       │└┴─ Branch code (optional, 500)
│       └┴── Location code (2 chars, FF)
│     └┴──── Country code (2 chars, DE)
│ └┴┴┴────── Bank code (4 chars, DEUT)
└─────────── Account number (optional)

§Field Components

  • Account Number: Institution’s account for settlement (optional)
  • BIC Code: Business Identifier Code for institution identification
  • Bank Code: 4-letter code identifying the bank
  • Country Code: 2-letter ISO country code
  • Location Code: 2-character location identifier
  • Branch Code: 3-character branch identifier (optional)

§Usage Context

Field 54A is used in:

  • MT103: Single Customer Credit Transfer
  • MT200: Financial Institution Transfer
  • MT202: General Financial Institution Transfer
  • MT202COV: Cover for customer credit transfer
  • MT205: Financial Institution Transfer for its own account

§Business Applications

  • Correspondent banking: Establishing correspondent relationships
  • Payment routing: Directing payments through correspondent networks
  • Settlement coordination: Managing settlement between institutions
  • Cross-border payments: Facilitating international transfers
  • Liquidity management: Optimizing correspondent account balances
  • Risk management: Identifying counterparty institutions

§Examples

:54A:CHASUS33
└─── JPMorgan Chase Bank, New York (BIC only)

:54A:/1234567890123456789012345678901234
DEUTDEFF500
└─── Deutsche Bank AG, Frankfurt with account number

:54A:BARCGB22
└─── Barclays Bank PLC, London (8-character BIC)

:54A:/CORRESPONDENT001
BNPAFRPP
└─── BNP Paribas, Paris with correspondent account

§BIC Code Structure

  • 8-character BIC: BANKCCLL (Bank-Country-Location)
  • 11-character BIC: BANKCCLLBBB (Bank-Country-Location-Branch)
  • Bank Code: 4 letters identifying the institution
  • Country Code: 2 letters (ISO 3166-1 alpha-2)
  • Location Code: 2 alphanumeric characters
  • Branch Code: 3 alphanumeric characters (optional)

§Account Number Guidelines

  • Format: Up to 34 alphanumeric characters
  • Content: Correspondent account number or identifier
  • Usage: When specific account designation is required
  • Omission: When only institution identification is needed

§Validation Rules

  1. BIC format: Must be valid 8 or 11 character BIC code
  2. Bank code: Must be 4 alphabetic characters
  3. Country code: Must be 2 alphabetic characters
  4. Location code: Must be 2 alphanumeric characters
  5. Branch code: Must be 3 alphanumeric characters (if present)
  6. Account number: Maximum 34 characters (if present)
  7. Character validation: All components must be printable ASCII

§Network Validated Rules (SWIFT Standards)

  • BIC must be valid and registered in SWIFT network (Error: T10)
  • BIC format must comply with ISO 13616 standards (Error: T11)
  • Account number cannot exceed 34 characters (Error: T14)
  • Bank code must be alphabetic only (Error: T15)
  • Country code must be valid ISO 3166-1 code (Error: T16)
  • Location code must be alphanumeric (Error: T17)
  • Branch code must be alphanumeric if present (Error: T18)
  • Field 54A alternative to 54B/54D (Error: C54)

Fields§

§account_line_indicator: Option<String>

Account line indicator (optional, 1 character)

§account_number: Option<String>

Account number (optional, up to 34 characters)

§bic: BIC

BIC code (8 or 11 characters)

Implementations§

Source§

impl Field54A

Source

pub fn new( account_line_indicator: Option<String>, account_number: Option<String>, bic: impl Into<String>, ) -> Result<Self, ParseError>

Create a new Field54A with validation

Source

pub fn account_line_indicator(&self) -> Option<&str>

Get the account line indicator

Source

pub fn account_number(&self) -> Option<&str>

Get the account number

Source

pub fn bic(&self) -> &str

Get the BIC code

Source

pub fn is_full_bic(&self) -> bool

Check if this is a full BIC (11 characters) or short BIC (8 characters)

Source

pub fn description(&self) -> String

Get human-readable description

Trait Implementations§

Source§

impl Clone for Field54A

Source§

fn clone(&self) -> Field54A

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Field54A

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for Field54A

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Display for Field54A

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Field54A

Source§

fn eq(&self, other: &Field54A) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for Field54A

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl SwiftField for Field54A

Source§

fn parse(value: &str) -> Result<Self, ParseError>

Parse field value from string representation
Source§

fn to_swift_string(&self) -> String

Convert field back to SWIFT string format
Source§

fn validate(&self) -> ValidationResult

Validate field according to SWIFT format rules
Source§

fn format_spec() -> &'static str

Get field format specification
Source§

impl Eq for Field54A

Source§

impl StructuralPartialEq for Field54A

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,