Bank Transfer Parameters

ParameterTypeDescription
beneficiaryTypestringRecipient type. This field is case-sensitive. Possible values:
  • Individual - recipient is a natural person
  • Business - recipient is a legal entity
beneficiaryCountryCodestringISO country number of the beneficiary bank. Input requirement:
  • Digits
  • Length - 3 characters
Not required for transfers to UK in GBP
beneficiaryCitystringRecipient’s city. Input requirement:
  • Latin characters
  • Digits
  • Special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 34 characters.
Not required for transfers to UK in GBP
beneficiaryAddressstringRecipient’s address. Input requirement:
  • Latin characters
  • Digits
  • Special characters such as: space [] (),;?: ' & ""/±
  • Length - 1 to 34 characters.
Not required for transfers to UK in GBP
beneficiaryStateOrProvincestringRecipient's state or province. Input requirement:
  • Latin characters
  • Special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 34 characters.
Not required for transfers to UK in GBP
beneficiaryNamestringThe bank transfer recipient's name. Input requirement:
  • Latin characters
  • Digits
  • Special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 55 characters.
Field required for beneficiaryType = Business
beneficiaryFirstNamestringThe bank transfer recipient's name. Input requirement:
  • Latin characters
  • Digits
    special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 55 characters.
Field required for beneficiaryType = Individual
beneficiaryLastNamestringThe bank transfer recipient's surname. Input requirement:
  • Latin characters
  • Digits
  • Special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 55 characters.
Field required for beneficiaryType = Individual
BeneficiaryRegistrationNumberstringRecipient’s registration number. Input requirement:
  • Latin characters
  • Digits
  • Special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 34 characters
Object required for beneficiaryCountryCode = 428 (Latvia)
beneficiarySortCodestringSort code of the receiving bank in the UK. Input requirement:
  • 6 digits
Field required for transfers to UK in GBP
intermediaryAccountobject

Information about the recipient’s account

For Faster Payments, SEPA and TARGET2 transfers, the intermediary bank is not required

intermediaryAccount.accountstringBank-correspondent account number. Input requirement:
  • Digits
  • Special characters such as: [] (),;?: ' & "/±
  • Length - 1 to 34 characters
intermediaryAccount.bankIdentitystringBank-correspondent SWIFT-code. Input requirement:
  • Latin characters
  • Digits
  • Length - 8 to 11 characters
intermediaryAccount.bankCountryCodestringISO country number of the bank-correspondent. Input requirement:
  • Digits
  • Length - 3 characters
beneficiaryAccountobjectInformation about the recipient’s account
beneficiaryAccount.accountstringRecipient’s bank account number/IBAN. Input requirement:
  • Latin characters
  • Digits
  • Special characters such as: space [] (),;?: ' & "/±
  • Length - 1 to 34 characters
beneficiaryAccount.bankIdentitystringBeneficiary bank SWIFT-code. Input requirement:
  • Latin characters
  • Digits
  • Length - 8 to 11 characters
beneficiaryAccount.bankCountryCodestringBeneficiary bank ISO-code. Input requirement:
  • Digits
  • Length - 3 characters
detailsstringDetails of the transfer. Input requirement:
  • No line breaks
  • Latin characters
  • Digits
  • Special characters - except < > can be used
  • Length - 1 to 120 characters