SWIFT

International wire transfer via the SWIFT network. Used for cross-border pay-out.

SWIFT transfers are the standard for international cross-border payments. They route through correspondent banks and typically settle in 1–5 business days depending on the currency and destination country.

Countries: International | Currency: Multi | Direction: Pay-out

Required fields

Field	Type	Description
type	string	Must be "SWIFT"
currency	string	Currency of the transfer (e.g., "USD", "EUR")
swift.bank.accountNumber	string	Recipient's bank account number
swift.swiftCode	string	SWIFT/BIC code of the recipient's bank
swift.customer.firstName	string	Recipient's first name
swift.customer.lastName	string	Recipient's last name
swift.customer.email	string	Recipient's email
swift.customer.documentNumber	string	ID or tax number
swift.customer.documentType	string	Document type
swift.iban	string	IBAN (required for SEPA-zone recipients)

Example

{
  "type": "SWIFT",
  "currency": "USD",
  "swift": {
    "swiftCode": "BNPAFRPPXXX",
    "bank": {
      "accountNumber": "00012345678"
    },
    "customer": {
      "firstName": "Pierre",
      "lastName": "Dupont",
      "email": "[email protected]",
      "documentType": "PASSPORT",
      "documentNumber": "FR1234567"
    }
  }
}

Schema

The swift object

Attributes

swiftCodestringRequired

SWIFT/BIC code of the recipient's bank.

accountNumberstringRequired

Recipient's bank account number.

bankNamestringOptional

Name of the recipient's bank.

The swift object

{
  "swiftCode": "text",
  "accountNumber": "text",
  "bankName": "text",
  "customer": {
    "id": "text",
    "firstName": "text",
    "email": "text",
    "lastName": "text",
    "phoneNumber": "text",
    "phoneNumberPrefix": "text",
    "documentType": "text",
    "documentNumber": "text",
    "address": {
      "administrativeAreaLevel1": "text",
      "administrativeAreaLevel2": "text",
      "administrativeAreaLevel3": "text",
      "street": "text",
      "streetNumber": "text",
      "optionalAddress": "text",
      "country": "text",
      "zipcode": "text"
    }
  }
}