Tutorial: Create International SWIFT Wire Transfers

📘
API Ref: Create SWIFT Wire Payment

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

curl --location 'https://api.stage.mbanq.cloud/v1/payments' \
--header 'tenantId: default' \
--header 'instance: default' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ2aW5vZDExIiwidXNlcl9qd3RfbG9naW4iOnRydWUsImlzQWNjZXNzVG9rZW4iOnRydWUsImV4cCI6MTc1MDI0NDAxNiwidXNlcklkIjo4ODAsImlhdCI6MTc1MDI0MDQxNiwib2F1dGhfY2xpZW50X2lkIjoiYmFja29mZmljZSJ9.ANwRfaN-Vm7veTUNKCPOvfvgCphgOCYC1I5uvB-lu2g0pbsqMVEQYwPl_uOuhXgvKZ5BQC1p1SvQcgih_8FGpA' \
--data '{
            "paymentType": "CREDIT",
            "paymentRail": "SWIFT",
            "amount": 10,

            "originator": {
              "accountId": "0000602"
            },
            "recipient": {

              "accountNumber": "4527", 
              "name": "Jessica Friedrichs",              

                  "accountType": "CHECKING",
              "address": {
                "line1": "415 N Oakhurst", 

                "stateCode": "AZ",
                "countryCode": "US",	   
                "postalCode": "85288",
                      "city": "Banglore"
              },
              "bankInformation": {               
                "swiftCode": "BUKBGB22" ,
                      "agent": {
            "name": "Citibank Luxembourg",
            "identifier": "CITILULX",
            "country": "LU",
            "address": [
              "31 Z.A. Bourmicht",
              "L-8070 Bertrange"
            ],
            "stateOrProvince": "Luxembourg District",
            "city": "Bertrange",
            "postalCode": "8070"
            }

              }
            },
            "reference": "Paramguru Payment",         
            "forFurtherCredit" : "MV VYSYA BANK ACC NUM1234656" 
        }'

Parameter	Value Type	Definition
paymentType	String	Indicates the type of transaction, e.g., "CREDIT" for sending funds.
paymentRail	String	Specifies the payment network/rail, here "SWIFT".
amount	Numeric	Amount of money to be transferred.
originator.accountId	String	Account ID of the sender/originator of the payment.
recipient.accountNumber	String	Recipient’s bank account number.
recipient.name	String	Full legal name of the recipient.
recipient.accountType	String	Type of recipient's account, e.g., "CHECKING"
recipient.address.line1	String	Address line 1 of the recipient’s address.
recipient.address.stateCode	String	State code where the recipient resides (e.g., "AZ").
recipient.address.countryCode	String	Country code of Recipient
recipient.address.postalCode	String	Postal or ZIP code of the recipient’s address.
recipient.address.city	String	City of the recipient’s address.
recipient.bankInformation.swiftCode	String	SWIFT code for the recipient’s bank.
recipient.bankInformation.agent.name	String	Name of the intermediary (agent) bank handling SWIFT transfer.
recipient.bankInformation.agent.identifier	String	Identifier (usually SWIFT code) of the agent bank.
recipient.bankInformation.agent.country	String	Country code of the agent bank
recipient.bankInformation.agent.address	List	Detailed Address of the agent bank
recipient.bankInformation.agent.stateOrProvince	String	State or province of the agent bank.
recipient.bankInformation.agent.city	String	City where the agent bank is located.
recipient.bankInformation.agent.postalCode	String	Postal code of the agent bank.
reference	String	Free-text purpose or description of the transaction.
forFurtherCredit	String	Additional instruction to credit a third-party account (nested account).

If the request is successful, you will receive a response containing ClientId, PaymentId etc. mentioned below.

{
    "id": "158898",
    "clientId": 770,
    "resourceId": 158898,
    "resourceIdentifier": "1750308710648cX"
}

Parameter	Value Type	Definition
id	string	The unique identifier of the data.
clientId	Long	Client Id
resourceId	Long	Payment Id
resourceIdentifier	String	Resource Identitfier

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