What are the validation rules for a FX batch payment?

Stephanie Boukhari
2026-03-31T21:27:02Z

Field | Required? | Validation Requirements
Amount | YES | only numbers
Direction | YES | Enter Sell or Buy
SellCurrencyCode | YES | 3 characters ISO format (see below)
BuyCurrencyCode | YES | 3 characters ISO format (see below)
Reason | YES | maximum 30 characters
Reference | YES | maximum 90 characters
CountryCode | YES | 2 characters ISO format
FirstName | required if CompanyName is empty | maximum 35 characters
LastName | required if CompanyName is empty | -
CompanyName | required if FirstName and LastName are empty | -
Address | YES | maximum 255 characters
City | YES | -
PostCode | YES | -
State | required for USA payments | -
BankAccountNumber | required if IBAN and BankClabe are empty | -
IBAN | required if BankAccountNumber and BankClabe are empty | -
BankClabe | required if BankAccountNumber and IBAN are empty | -
BankSortCode | required if BankBIC and BankABA are empty | -
BankBIC | required if BankSortCode and BankABA are empty | -
BankABA | required if BankSortCode and BankBIC are empty | -
DefaultPaymentReason | - | maximum 20 characters

please note - all character counts include spaces

FX Batch payments are compatible with the following buy/sell currencies:

SellCurrencyCode | BuyCurrencyCode
GBP | AED
EUR | BGN
USD | CZK
AUD | HRK
NOK | HUF
CHF | KES
HKD | KWD
PLN | MXN
ZAR | OMR
SEK | QAR
NZD | RON
JPY | SAR
CAD | SGD
DKK | THB
ILS | TRY
- | UGX
| + all currencies under SellCurrencyCode