Create International Wire Transfer

post https://api.cloud.mbanq.com/v1/payments (for International Wire Transfer)

Use this API for Payment of funds using SWIFT Network. You need to specify the account details of originator and recipient. An outgoing Credit can be initiated using this Payment Rail.

Please checkout the page at SWIFT to understand more about SWIFT Payment Rail.

During the lifecycle of a transfer, its status may undergo changes. Refer to the Transfer Status page at Transfer Status for detailed descriptions associated with each status.

The address information is available at Address Info

Note: All the payment API's have the endpoint: /payments

Body Params

paymentType

string

enum

required

Defaults to CREDIT

Specifying the type of payment during the transfer. For pull payment, CREDIT is the paymentType. Example: CREDIT

Allowed:

paymentRail

string

enum

required

Defaults to SWIFT

The SWIFT would be the default payment rail for pull transfer. Example: SWIFT

Allowed:

amount

number

required

Defaults to 10

The amount to be transferred in USD. Pattern: Maximum amount is defined by the transfer limits configured. Example: 10

originator

object

required

The details of the originator for the transfer.

recipient

object

required

The recipient for the transfer.

reference

string

length ≤ 140

Defaults to transferring to amy

The customer/originator reference for the transfer. It will be shown in the customer statement. Character Restrictions Encoding: UTF-8 Supported Characters:

Latin letters: a-z, A-Z Digits: 0-9 SWIFT-compatible special characters: ! # & % * = ^ _ ' { | } ~ " ; @ [ \ ] $ > <

Note: Special characters may undergo mapping or sanitization during processing. Extended Character Support: It accept international characters including accented letters and various alphabets supported by UTF-8 encoding. Example: transferring to amy

correlationId

string

Unique identifier for tracking the transaction. Maximum length: 100 characters.

forFurtherCredit

string

length ≤ 195

The reference for future credit. Example: MV VYSYA BANK ACC NUM1234656

Language

Credentials

Bearer

JWT


xxxxxxxxxx
1
curl --request POST \
2
     --url 'https://api.cloud.mbanq.com/v1/payments%20(for%20International%20Wire%20Transfer)' \
3
     --header 'content-type: application/json' \
4
     --data '
5
{
6
  "paymentType": "CREDIT",
7
  "paymentRail": "SWIFT",
8
  "amount": 10,
9
  "originator": {
10
    "accountId": 123456
11
  },
12
  "recipient": {
13
    "name": "David Wise",
14
    "accountNumber": 950003434343,
15
    "accountType": "CHECKING",
16
    "recipientType": "INDIVIDUAL",
17
    "address": {
18
      "line1": "123 Main Street",
19
      "city": "Park City",
20
      "stateCode": "CA",
21
      "countryCode": "US",
22
      "postalCode": 85281
23
    },
24
    "contactNumber": 1333444992,
25
    "bankInformation": {
26
      "swiftCode": "BUKBGB22",
27
      "agent": {
28
        "name": "Citibank Luxembourg",
29
        "identifier": "CITILULX",
30
        "address": [
31
          "31 Z.A. Bourmicht",
32
          "L-8070 Bertrange"
33
        ]
34
      }
35
    }
36
  },
37
  "reference": "transferring to amy"
38
}
39
'

Click Try It! to start a request and see the response here!