Tutorial: Create Domestic Wire Transfer

📘

WIRE payments are widely used for secure and reliable domestic and international fund transfers. The MBanq Cloud API allows developers to make WIRE payments, facilitating seamless transactions. Below is a tutorial on how developers can make WIRE payments using the MBanq Cloud API

  1. WIRE Transfer Request

    To execute a WIRE 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": "WIRE",
              "amount": 1,
    
              "originator": {
                "accountId": "000000293"
              },
              "recipient": {
    
                "name": "Cemet Consulting LLC",    
                "accountNumber": "000000321",   
                "contactNumber" : "+13334449999",
    
                "address": {
                  "line1": "415 N Oakhurst", 
                  "line2": "Dr, Apt 106",  
                  "city": "Park City",  
                  "mobileNo":" +13334449999",
                  "stateCode": "AZ",
                  "countryCode": "US",	   
                  "postalCode": "85288"
                },
                "bankInformation": {              
                  "routingNumber": "321070007"  
                }
              },
              "reference": "Pago general serv",     
              "forFurtherCredit" : "MV VYSYA BANK ACC NUM1234656" 
            }'
    ParameterValue TypeExplanation
    paymentTypeStringType of the transaction; "CREDIT" means sending funds to a recipient. (CREDIT or DEBIT)
    paymentRailStringPayment rail/network used, e.g., "WIRE" for wire transfer.
    amountNumericSpecifies the transfer amount
    originator.accountIdStringThe account ID of the sender/originator.
    recipient.nameStringName of the recipient receiving the funds.
    recipient.accountNumberStringRecipient's bank account number.
    recipient.contactNumberStringPhone number of the recipient.
    recipient.address.line1StringAddress Line 1 of the recipient's address.
    recipient.address.line2StringAddress Line 2 of the recipient's address.
    recipient.address.cityStringCity in the recipient’s address.
    recipient.address.mobileNoStringMobile number of the recipient.
    recipient.address.stateCodeStringState code in the recipient’s address
    recipient.address.countryCodeStringCountry code of the recipient.
    recipient.address.postalCodeStringZIP/postal code in the recipient’s address
    recipient.bankInformation.routingNumberStringRouting number for WIRE payments.
    referenceStringFree-text description or memo for the transaction.
    forFurtherCreditStringAdditional instruction to credit another party, e.g., intermediary bank.

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