Skip to content

/

/

SEPA EU

← Back to BAV docs

SEPA EU

Overview

Available	Yes
`targetCurrency`	Euro (EUR)
`countryCode`	Use a valid VoP supported EU
VoP supported countries	Austria, Belgium, Croatia, Cyprus, Estonia, Finland, France, Germany, Greece, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Portugal, Slovakia, Slovenia, Spain

Submission data

API field name	Required?	Field length	Description
`instructions.party.payoutInstrument.iban`	✅	22	Beneficiary IBAN. The format the IBAN varies by country. See Additional data for a list by country.
`instructions.party.payoutInstrument.swiftBic`	✅	8 or 11	The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
`instructions.party.payoutInstrument.bankName`	❌	Max 35	Name of the beneficiary bank.
`instructions.party.type`	✅	N/A	Type of the party. Must be: `beneficiary`
`instructions.party.payoutInstrument.accountType`	✅	N/A	Type of the account. Available values: `checking` `savings` `moneyMarket` `certificateOfDeposit` `vista` `other`
`instructions.party.payoutInstrument.accountHolderName`	Conditional	Min 2 and Max 70	Beneficiary 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 `instructions.party.personalDetails.type` is `person` and `instructions.party.personalDetails.firstName` and/or `instructions.party.personalDetails.lastName` are not provided. Or if `instructions.party.personalDetails.type` is `company` and the `instructions.party.personalDetails.companyName` is not provided.
`instructions.party.personalDetails.type`	✅	N/A	Entity description code for the party. Available values: `company` `person` `soleTrader` `institution` `government`
`instructions.party.personalDetails.title`	Conditional	N/A	Title code for the individual. Available values: `ms` `mrs` `mr` `miss` `dr` `mx` `misc` Condition Mandatory if `instructions.party.personalDetails.type` is: `person`
`instructions.party.personalDetails.firstName`	Conditional	Max 35	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `instructions.party.personalDetails.type` is: `person`
`instructions.party.personalDetails.middleName`	❌	Max 35	Beneficiary middle name.
`instructions.party.personalDetails.lastName`	Conditional	Max 35	Beneficiary last name. Full name should be provided (no initials). Condition Full Name (First + Middle + Last name) must be between 2 and 70 characters, including spaces and any other characters. Mandatory if `instructions.party.personalDetails.type` is: `person`
`instructions.party.personalDetails.companyName`	Conditional	Max 70	Full name of the organizations. Condition Mandatory if `instructions.party.personalDetails.type` is: `company` `institution` `government` `other`
`instructions.party.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`instructions.party.personalDetails.dateOfIncorporation`	❌	10	A company`s date of incorporation in YYYY-MM-DD format.
`instructions.party.address.address1`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`instructions.party.address.address2`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`instructions.party.address.city`	❌	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`instructions.party.address.postalCode`	❌	Max 10	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`instructions.party.address.countryCode`	✅	2	Beneficiary'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.