SWIFT

Rail overview

Use SWIFT for cross-border bank payouts where local rails are not available.

SWIFT transfers can pass through correspondent banks; Conomy tracks provider states while the payout moves toward completion or failure.

Region International

Currency Cross-border

Direction Pay-out

Model International wire

Collect beneficiary, bank, country, and intermediary details carefully. SWIFT is the most data-sensitive payout rail.

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

Optional fields

Field	Type	Description
swift.bank.name	string	Recipient bank name.
swift.iban	string	IBAN (required only for destinations that enforce IBAN format, such as SEPA-zone recipients).

Example

{
  "type": "SWIFT",
  "currency": "USD",
  "swift": {
    "swiftCode": "BNPAFRPPXXX",
    "bank": {
      "accountNumber": "00012345678"
    },
    "customer": {
      "firstName": "Pierre",
      "lastName": "Dupont",
      "email": "pierre@example.com",
      "documentType": "PASSPORT",
      "documentNumber": "FR1234567"
    }
  }
}

Object

swiftCodestringrequired

SWIFT/BIC code of the recipient's bank.

ibanstring

Recipient IBAN when destination country requires it (typically SEPA zone).

bankobjectrequired

Recipient bank account details.

accountNumberstringrequired

Recipient's bank account number.

namestring

Name of the recipient's bank.

customerobjectrequired

Beneficiary identity data required by correspondent banks.

idstring

Unique identifier for the internal service.

firstNamestringrequired

Payer's name

emailstringrequired

Payer's email

lastNamestringrequired

Payer's last name

phoneNumberstring

Payer's phone number without prefix

phoneNumberPrefixstring

Phone number prefix (e.g., +57)

documentTypestringrequired

Documeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.

documentNumberstringrequired

The document number associated with the documentType

addressobjectshow 8 properties

The entity’s address information.