UI Elements

General

Individual elements of the form can be shown, hidden, or adjusted independently. This allows you to keep the interface minimal for embedded flows or provide a more complete experience for standalone use.

Header

The form header can be shown or hidden. Hiding the header also removes the language selector.

If you hide the header, lock the form to a specific language to ensure the desired language is used. See Language & Localization.

Cancel Button

The Cancel button allows users to exit the current flow. You can hide it when your application provides its own cancellation option.

Note: Only hide the Cancel button when the form is embedded in your own container and your application handles cancellation. When a user cancels through your application, call the Cancel a web form service (POST /api/webForms/{id}/cancel).

Progress Bar

The progress bar indicates the user's current position in the flow. It can be shown or hidden.

Footer & Logos

The footer includes two trust indicators: the finAPI attribution and the TÜV certification mark.

The TÜV mark can be hidden for a cleaner appearance. The finAPI attribution remains visible, but you can choose whether it is displayed as the finAPI logo or as plain "finAPI" text.

Bank Banner

During login and authentication, the form displays a banner with the selected bank's branding. You can hide the banner for a more neutral appearance.

Featured Bank Groups

The bank search can display a curated selection of bank groups for quick access. You can choose to show or hide these featured groups.

Bank Search Default Country

You can define which country is preselected when the bank search opens. Set this to the country most relevant to your users or primary market.

Bank Login Hint

Some banks provide additional information to help users identify their login credentials. You can control how this hint is displayed:

• Expanded — the hint is visible by default.

• Collapsed — users can expand the hint when needed.

• Hidden — the hint is not displayed.

Terms & Conditions

The terms and conditions text supports two presentation styles:

• BASIC — states that the connection is established via finAPI.

• EXPLICIT — additionally identifies the services used for the connection: account information (AIS) and payment initiation (PIS).

Technical Setup

Configure UI element settings under functionality in the profile. The finAPI footer attribution is configured separately under brand.

All fields are optional. If a field is not specified, the default value listed in the corresponding table applies.

Fields

Example

{
  "brand": {
    "finapiFooterBranding": "ICON"
  },
  "functionality": {
    "header": "RENDER",
    "cancelButton": "RENDER",
    "tuvLogo": "RENDER",
    "bankBanner": "RENDER",
    "featuredBankGroups": "RENDER",
    "bankSearch": {
      "defaultCountry": "DE"
    },
    "bankLoginHint": "EXPANDED",
    "termsAndConditionsText": "EXPLICIT"
  }
}