A quick reference for the account_information fields required when creating a counterparty for each payment rail. For complete validation rules including profile and customer identity fields, see Counterparty Validation.
| Rail | Counterparty Type | Jurisdiction | Required account_information Fields |
|---|---|---|---|
ACH | FIAT_US | ๐บ๐ธ United States | account_number, routing_number |
FEDWIRE | FIAT_US | ๐บ๐ธ United States | account_number, routing_number |
SEPA_CT | FIAT_EU | ๐ช๐บ Europe | iban, swift_bic, institution_name, institution_address |
FPS | FIAT_GB | ๐ฌ๐ง United Kingdom | account_number, institution_name, institution_address |
CHAPS | FIAT_GB | ๐ฌ๐ง United Kingdom | account_number, institution_name, institution_address |
IMPS ยท NFT ยท UP | FIAT_IN | ๐ฎ๐ณ India | account_number, institution_name, institution_address |
EFT | FIAT_CA | ๐จ๐ฆ Canada | institution_number, institution_name, institution_address |
SWIFT | All FIAT types | ๐ Global | Varies by counterparty type โ see detailed sections below |
ACH | FIAT_BS | ๐ง๐ธ Bahamas | account_number, institution_name, institution_address |
The tables below list all fields within account_information. โ
denotes a required field.
Supported Rails: ACH ยท FEDWIRE ยท SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
routing_number | โ | ABA routing number |
type | ย | Account type: CHECKING or SAVING |
swift_bic | ย | SWIFT/BIC code โ recommended when using SWIFT |
institution_name | ย | Bank name (e.g. Bank of America) |
institution_address | ย | Bank address โ see Address Object |
Supported Rails: SEPA_CT ยท SWIFT
| Field | Required | Description |
|---|---|---|
iban | โ | International Bank Account Number |
swift_bic | โ | SWIFT/BIC code |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
Supported Rails: FPS ยท CHAPS ยท SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
sort_code | ย | 6-digit sort code (######) โ recommended for FPS and CHAPS |
iban | ย | IBAN โ recommended for SWIFT |
swift_bic | ย | SWIFT/BIC code โ recommended for SWIFT |
Supported Rails: IMPS ยท NFT ยท UP ยท SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
ifsc | ย | Indian Financial System Code โ required for IMPS and NFT |
swift_bic | ย | SWIFT/BIC code โ required for SWIFT |
Supported Rails: EFT ยท SWIFT
| Field | Required | Description |
|---|---|---|
institution_number | โ | 3-digit financial institution number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
account_number | ย | Account number |
transit_number | ย | 5-digit branch transit number |
swift_bic | ย | SWIFT/BIC code โ recommended for SWIFT |
Supported Rails: SWIFT
For jurisdictions that use IBAN identification and are not covered by a country-specific counterparty type.
| Field | Required | Description |
|---|---|---|
iban | โ | International Bank Account Number |
swift_bic | โ | SWIFT/BIC code |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
Supported Rails: SWIFT
For jurisdictions that use account number identification and are not covered by a country-specific counterparty type.
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
routing_number | โ | Routing or sort identifier |
swift_bic | โ | SWIFT/BIC code |
type | ย | Account type: CHECKING or SAVING |
institution_name | ย | Bank name |
institution_address | ย | Bank address โ see Address Object |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
swift_bic | ย | SWIFT/BIC code |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
swift_bic | ย | SWIFT/BIC code |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
swift_bic | ย | SWIFT/BIC code |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
swift_bic | ย | SWIFT/BIC code |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
swift_bic | ย | SWIFT/BIC code |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
swift_bic | ย | SWIFT/BIC code |
Supported Rails: SWIFT
| Field | Required | Description |
|---|---|---|
account_number | โ | Account number |
institution_name | โ | Bank name |
institution_address | โ | Bank address โ see Address Object |
type | ย | Account type: CHECKING or SAVING |
swift_bic | ย | SWIFT/BIC code |
The institution_address object appears within account_information across all FIAT counterparty types. All fields are optional.
| Field | Description |
|---|---|
address_line1 | Street address line 1 |
address_line2 | Street address line 2 |
address_line3 | Street address line 3 |
unit_number | Unit or suite number |
city | City |
state | State or province |
postal_code | Postal or ZIP code |
country_code | ISO 3166-1 alpha-2 country code (e.g. US, GB, DE) |