Skip to content
APIs/
/
/
SEPA EU

← Back to BAV docs

SEPA EU

Overview

AvailableYes
targetCurrencyEuro (EUR)
countryCodeUse a valid VoP supported EU
VoP supported countriesAustria, Belgium, Croatia, Cyprus, Estonia, Finland, France, Germany, Greece, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Portugal, Slovakia, Slovenia, Spain

Submission data

API field nameRequired?Field lengthDescription
beneficiaryBankDetails.iban✅22Beneficiary IBAN.
The format the IBAN varies by country. See Additional datafor a list by country.
beneficiaryBankDetails.swiftBic✅8 or 11The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
beneficiaryBankDetails.bankName❌Max 35Name of the beneficiary bank.
parties.partyType✅N/AType of the party.
Must be:
  • beneficiary
parties.accountType✅N/AType of the account.
Available values:
  • checking
  • savings
  • moneyMarket
  • certificateOfDeposit
  • vista
  • other
parties.accountHolderNameConditionalMin 2 - Max 70Beneficiary full name. You must provide the full name (not initials). Name must be between 2 and 70 characters, including spaces and any other characters. Additionally, both the first name and last name must not individually exceed 35 characters, including spaces and any other characters. We treat any character or word after the first space in the name as part of the last name. For example, in the name "John Michael Doe", the first name is "John" and the last name is "Michael Doe".
Condition
Mandatory if parties.personalDetails.type is person and parties.personalDetails.firstName and/or parties.personalDetails.lastName are not provided.

Or if parties.personalDetails.type is company and the parties.personalDetails.companyName is not provided.
parties.personalDetails.type✅N/AEntity description code for the party.
Available values:
  • company
  • person
  • soleTrader
  • institution
  • government
parties.personalDetails.titleConditionalN/ATitle code for the individual.
Available values:
  • ms
  • mrs
  • mr
  • dr
  • mx
  • misc
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.middleName❌Max 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.companyNameConditionalMax 140Full name of the organizations.
Important
Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.
Condition
Mandatory if parties.personalDetails.type is:
  • company
  • institution
  • government
  • other
parties.personalDetails.dateOfBirth❌10Beneficiary's date of birth in YYYY-MM-DD format.
parties.personalDetails.dateOfIncorporation❌10A companys date of incorporation in YYYY-MM-DD format.
parties.address.address1❌Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
parties.address.address2❌Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.city❌Max 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.postalCode❌Max 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCode✅2Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address.
Enter the 2 character ISO 3166-1 standard country code in your API request.