SWIFT MT/MX to DBIS Nostro/Vostro API Mapping

Overview

This document provides mapping guidance for converting SWIFT messages to DBIS Nostro/Vostro API requests.

Message Types

MT103 (Customer Credit Transfer)

SWIFT Format:

{1:F01BANKUS33AXXX1234567890}
{2:O1031200240115BANKUS33AXXX123456789012345678901234567890}
{3:{108:TRF123}}
{4:
:20:TRF123
:23B:CRED
:32A:240115USD1000,00
:50K:/1234567890
JOHN DOE
:59:/GB82WEST12345698765432
JANE SMITH
:70:PAYMENT REFERENCE
-}

DBIS API Request:

{
  "fromAccountId": "1234567890",
  "toAccountId": "GB82WEST12345698765432",
  "amount": "1000.00",
  "currency": "USD",
  "valueDate": "2024-01-15",
  "reference": "TRF123",
  "metadata": {
    "swiftMessageType": "103",
    "swiftReference": "TRF123"
  }
}

MT202 (General Financial Institution Transfer)

Similar to MT103 but for interbank transfers.

MX (ISO 20022) Messages

See ISO 20022 Mapping Guide for MX message handling.

Field Mappings

SWIFT Field	DBIS API Field	Notes
`:20:`	`reference`	Transaction reference
`:32A:` (date)	`valueDate`	Value date (YYMMDD format)
`:32A:` (currency)	`currency`	Currency code
`:32A:` (amount)	`amount`	Transfer amount
`:50K:` or `:50A:`	`fromAccountId`	Ordering customer account
`:59:`	`toAccountId`	Beneficiary account
`:52A:`	`fromParticipantId`	Sender BIC
`:56A:`	`toParticipantId`	Receiver BIC
`:70:`	`reference`	Remittance information

Implementation

Use the SwiftAdapter class:

import { SwiftAdapter } from '@/integration/plugins/swift-adapter';

const adapter = new SwiftAdapter();
const swiftMessage = adapter.parseSwiftMessage(mt103String);
const transferRequest = adapter.mapTransfer(swiftMessage);

Date Format Conversion

SWIFT uses YYMMDD format, DBIS uses ISO 8601:

// SWIFT: 240115
// DBIS: 2024-01-15

Error Handling

SWIFT errors map to DBIS error codes:

SWIFT Error	DBIS Error Code
Invalid message format	`VALIDATION_ERROR`
Account not found	`NOT_FOUND`
Invalid BIC	`VALIDATION_ERROR`

2.2 KiB Raw Blame History