Parser SWIFT MT

Décodez un message SWIFT MT (FIN) bloc par bloc, 100 % côté client. MT103, MT202, MT940 et bien d'autres ; en-têtes, tags, trailer.

Comment ça marche

Un message SWIFT MT (FIN) est structuré en cinq blocs délimités par des accolades, chacun précédé de son identifiant numérique (1 à 5). Le parser tokenise les blocs en respectant l'imbrication des accolades, puis interprète chacun selon sa grammaire propre :

• Bloc 1 — Basic Header, taille fixe : application id (F), service id, adresse LT (12 caractères), numéro de session, numéro de séquence.
• Bloc 2 — Application Header. Le premier caractère indique la direction (I input ou O output) ; les 3 suivants sont le type de message (103, 202, 940…).
• Bloc 3 — User Header, optionnel. Sous-blocs {key:value} : priorité bancaire, MUR (Message User Reference), End-to-End Reference UETR (GPI).
• Bloc 4 — Text. Le corps applicatif. Chaque ligne commence par :tag:, suivi de la valeur (parfois multi-ligne). Le marqueur - en fin de bloc clôt le texte.
• Bloc 5 — Trailer. Sous-blocs MAC, CHK, PDE, PDM, DLM pour authentification, checksum, gestion des duplicats.

Structure en blocs

{1:F01BANKBEBBAXXX0000000000}
{2:I103BANKDEFFXXXXN}
{3:{108:MUR123456789}{121:cf3a4f5e-...}}
{4:
:20:REF12345
:23B:CRED
:32A:260516EUR1000,00
:50K:/12345678
ACME COMPANY LTD
:59:/12345678901234567890
BENEFICIARY NAME
:70:/INV/2026-001
:71A:OUR
-}
{5:{CHK:1234567890AB}}

Tags courants par message type

Le validateur d'enveloppe vérifie la présence des tags obligatoires pour les MT suivants :

• MT103 — Single Customer Credit Transfer : 20 (référence transaction), 23B (bank operation code), 32A (date valeur + devise + montant), 50a (donneur d'ordre), 59a (bénéficiaire), 71A (charge code).
• MT202 — General Financial Institution Transfer : 20, 21, 32A, 52a (institution donneur d'ordre), 58a (institution bénéficiaire).
• MT900 / MT910 — Confirmation of Debit / Credit : 20, 21, 25, 32A.
• MT940 — Customer Statement Message : 20, 25, 28C, 60a (solde initial), 61 (ligne de mouvement), 62a (solde final).
• MT942 — Interim Transaction Report : 20, 25, 28C, 34F, 90a.

Limites

• Le parser ne valide pas la syntaxe des montants, des dates ou des IBAN à l'intérieur des tags. Un :32A: mal formé reste passé tel quel.
• Les sous-séquences (séquences A, B, C dans MT564, MT566, etc.) ne sont pas reconstruites : la liste des tags reste plate.
• Le checksum CHK et le MAC ne sont pas vérifiés ; seuls leur présence et leur valeur brute sont surfaceés.
• L'outil ne gère pas le préambule MLLP : si vous recevez un message encapsulé, copiez le texte entre les délimiteurs.

Confidentialité

Documentation associée

• SWIFT MT — la vue d'ensemble du standard FIN, son histoire et son écosystème.
• ISO 20022 — le standard XML/JSON qui prend progressivement le relais (CBPR+, migration FIN → MX).
• SWIFT FIN User Handbook & Standards Release Guide — les références officielles ; swift.com — Standards overview.