Tutorial: Create International SWIFT Wire Transfers

📘
API Ref: Create SWIFT Wire Transfer

To execute a SWIFT transfer, send a POST request to the MBanq Cloud API with the following details:

curl -X POST https://api.cloud.mbanq.com/v1/transfers \
     -H "Content-Type: application/json" \
     -d '{
         "type": "CREDIT",
         "dateFormat": "dd MMMM yyyy",
         "paymentType": "SWIFT",
         "amount": 150,
         "reference": [],
         "debtor": {
             "identifier": "ACCOUNT:6666000000000223",
             "name": "Kole Castro"
         },
         "creditor": {
             "name": "TD Corporation Sarl",
             "agent": {
                 "identifier": "CITILULX",
                 "name": "CITIBANK EUROPE PLC",
                 "address": [
                     "LUXEMBOURG BRANCH",
                     "31 ZA BOURMICHT,",
                     "LU"
                 ],
                 "country": "LU"
             },
             "address": [
                 "37 Rue d'Anvers",
                 "1130 Luxembourg",
                 "LU"
             ],
             "identifier": "SWIFT://CITILULX/LU210340007000190877",
             "country": "LU",
             "city": "",
             "postalCode": ""
         },
         "paymentRailMetaData": {
             "businessFunctionCode": {
                 "businessFunctionCode": "CTR",
                 "transactionTypeCode": ""
             },
             "receiverDepositoryInstitution": {
                 "receiverABANumber": "021000018",
                 "receiverShortName": "BK OF NYC"
             },
             "originator": {
                 "personal": {
                     "identificationCode": "D"
                 }
             },
             "beneficiary": {
                 "personal": {
                     "identificationCode": "D"
                 }
             },
             "beneficiaryFI": {
                 "financialInstitution": {
                     "identificationCode": "B"
                 }
             },
             "beneficiaryIntermediaryFI": {
                 "financialInstitution": {
                     "identificationCode": "F",
                     "identifier": "8901233412",
                     "name": "Bankers Bank of the West",
                     "address": {
                         "addressLineOne": "099 18th St, Ste 2700",
                         "addressLineTwo": "Denver,CO 80202,US",
                         "addressLineThree": "US"
                     }
                 }
             },
             "typeSubType": {
                 "typeCode": "10",
                 "subTypeCode": "00"
             },
             "beneficiaryReference": {
                 "beneficiaryReference": "Client #558023"
             },
             "fiPaymentMethodToBeneficiary": {}
         }
     }'

Parameter	Value Type	Definition
type	string	Specifies the type of transfer, in this case, "CREDIT".
dateFormat	string	Specifies the format of the date, using the "dd MMMM yyyy" format.
paymentType	string	Specifies the type of payment, in this case, "SWIFT".
amount	number	Specifies the amount of the transfer, in this case, 150.
reference	array	Contains an empty array, indicating no specific references for the transfer.
debtor.identifier	string	Identifies the debtor's account using the format "ACCOUNT:6666000000000223".
debtor.name	string	Specifies the name of the debtor, in this case, "Kole Castro".
creditor.name	string	Specifies the name of the creditor, in this case, "TD Corporation Sarl".
creditor.agent.identifier	string	Identifies the agent using the format "CITILULX".
creditor.agent.name	string	Specifies the name of the agent, in this case, "CITIBANK EUROPE PLC".
creditor.agent.address	array	Contains an array of strings representing the address of the agent.
creditor.agent.country	string	Specifies the country of the agent, in this case, "LU" (Luxembourg).
creditor.address	array	Contains an array of strings representing the address of the creditor.
creditor.identifier	string	Identifies the creditor's account using the format "SWIFT://CITILULX/LU210340007000190877".
creditor.country	string	Specifies the country of the creditor, in this case, "LU" (Luxembourg).
creditor.city	string	Specifies the city of the creditor.
creditor.postalCode	string	Specifies the postal code of the creditor.
beneficiaryReference	object	Specifies the beneficiary reference.
beneficiaryReference.beneficiaryReference	string	Specifies the beneficiary reference, in this case, "Client #558023".

If the request is successful, you will receive a response containing the transfer ID and other relevant details.

{
    "data": {
        "id": "6",
        "type": "CREDIT",
        "status": "PENDING",
        ...
    }
}

Parameter	Value Type	Definition
id	string	The unique identifier of the data, in this case, "6".
type	string	Specifies the type of the data, in this case, "CREDIT".
status	string	Specifies the status of the data, in this case, "PENDING".
...	...	Additional parameters may exist but are not specified in the given example. Please refer to the API documentation for more details.

Please note that additional details and error handling might be required based on the specific implementation and business requirements.

📘API Ref: Create SWIFT Wire Transfer

📘
API Ref: Create SWIFT Wire Transfer