Struct Field52D

pub struct Field52D {
    pub name_and_address: Vec<String>,
}

Field 52D: Ordering Institution (Option D)

Overview

Field 52D identifies the ordering institution in SWIFT payment messages using name and address information rather than a BIC code. This option is used when the ordering institution does not have a BIC or when full name and address details are required for regulatory, compliance, or routing purposes.

Format Specification

Format: 4*35x

• 4*35x: Up to 4 lines of name and address information
• Line length: Maximum 35 characters per line
• Character set: SWIFT character set (printable ASCII)
• Content: Institution name, street address, city, country

Structure

Line 1: Institution Name
Line 2: Street Address
Line 3: City, State/Province, Postal Code
Line 4: Country (optional)

Usage Context

Field 52D is used in:

• MT103: Single Customer Credit Transfer (when 52A not available)
• MT200: Financial Institution Transfer
• MT202: General Financial Institution Transfer
• MT202COV: Cover for customer credit transfer

Business Applications

• Non-SWIFT institutions: Identifying institutions without BIC codes
• Regulatory compliance: Providing full address for compliance requirements
• Local banks: Identifying smaller banks or credit unions
• Correspondent banking: When full address details are required
• Sanctions screening: Enabling comprehensive name/address screening

Examples

:52D:FIRST NATIONAL BANK
123 MAIN STREET
ANYTOWN NY 12345
UNITED STATES
└─── US regional bank with full address

:52D:BANQUE REGIONALE SARL
45 RUE DE LA PAIX
PARIS 75001 FRANCE
└─── French regional bank (3 lines)

:52D:CREDIT UNION COOPERATIVE
789 COMMUNITY DRIVE
SMALLTOWN CA 90210
└─── Credit union (minimal address)

Address Format Guidelines

• Line 1: Institution legal name (required)
• Line 2: Street address/building number (recommended)
• Line 3: City, state/province, postal code (recommended)
• Line 4: Country name (optional but recommended for international)

Address Standards

• Use standard postal abbreviations
• Include postal/ZIP codes when available
• Spell out country names in full
• Avoid special characters and diacritical marks
• Use standard address formatting conventions

Validation Rules

1. Minimum content: At least 1 line required
2. Maximum lines: No more than 4 lines
3. Line length: Each line maximum 35 characters
4. Character validation: Only printable ASCII characters
5. Content requirement: Must contain meaningful institution information

Network Validated Rules (SWIFT Standards)

• Minimum 1 line, maximum 4 lines allowed (Error: C54)
• Each line cannot exceed 35 characters (Error: T14)
• Characters must be from SWIFT character set (Error: T61)
• Lines cannot be empty (Error: T11)
• Must contain institution name in first line (Error: C55)
• Field 52D alternative to 52A (Error: C52)

Fields

name_and_address: Vec<String>

Name and address lines (up to 4 lines of 35 characters each)

Implementations

impl Field52D

pub fn new(name_and_address: Vec<String>) -> Result<Self, ParseError>

Create a new Field52D with validation

pub fn from_string(content: impl Into<String>) -> Result<Self, ParseError>

Create from a single string, splitting on newlines

pub fn name_and_address(&self) -> &[String]

Get the name and address lines

pub fn line_count(&self) -> usize

Get the number of lines

pub fn line(&self, index: usize) -> Option<&str>

Get a specific line by index

pub fn add_line(&mut self, line: String) -> Result<(), ParseError>

Add a line of name/address information

pub fn description(&self) -> String

Get human-readable description

Trait Implementations

impl Clone for Field52D

fn clone(&self) -> Field52D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Field52D

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Field52D

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Field52D

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

Formats the value using the given formatter.

impl PartialEq for Field52D

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for Field52D

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SwiftField for Field52D

fn parse(content: &str) -> Result<Self>

Parse field value from string representation

fn to_swift_string(&self) -> String

Convert field back to SWIFT string format

fn validate(&self) -> ValidationResult

Validate field according to SWIFT format rules

fn format_spec() -> &'static str

Get field format specification

impl Eq for Field52D

impl StructuralPartialEq for Field52D