Web Form 2.0 Public Documentation

Web Form Documentation (2.0 / 2.1)

finAPI Web Form

The finAPI Web Form is an embeddable form that lets your end users authorize bank account access (AIS) and payments (PIS) with Strong Customer Authentication, as required for PSD2. You create a web form via the API, embed it in your app, and the user completes bank selection, login, and SCA inside it.

What "2.0" and "2.1" mean

The two version numbers do not mean "2.1 replaces 2.0". They describe different layers:

🟦 Web Form 2.0 = the product. The REST API, the integration model (loader, embedding, callbacks), environments, SDKs, and profiles. This is what you integrate against, and it is fully current.

🟩 Web Form 2.1 = the new UI. A redesigned user interface plus a new, richer theme API for customizing its look (colors, dark mode, typography, components). It is a new UI + styling layer on top of the 2.0 product — not a replacement for it.

So: you always integrate with the 2.0 product. When you customize appearance, please only do so with the new theme styling (the 2.1 UI). See [Web Form 2.0 vs 2.1 - in detail] and [Switching from 2.0 to 2.1].

Contents

  • Getting started - prerequisites, environments, your first web form

  • Integrating the Web Form - embedding with the loader, layout, callbacks, licensed-customer rules

  • Flows - AIS and PIS explained

  • Customizing the Web Form - profiles, branding, functionality, language, and the 2.1 theme

  • Migrations - from Web Form V1, and from 2.0 to 2.1

  • SDKs

  • Reference - status & error codes, supported languages