Getting Started - Web Form Integration

Introduction

A mandatory step for all Giro Ident flows is to enable the user to log on to his bank, using the finAPI bank login web form. The web form has its own separate detailed developer documentation:

https://documentation.finapi.io/webform/

Redirect the user to the Web Form

The result of creating a GiroIdent identity check contains the URL for the web form to be used for the user’s bank login.

CODE

{
    "check-id": "3a824de8-1049-475c-89c4-71ad9716d379",
    "redirect-url": "https://webform-sandbox.finapi.io/wf/0cfb4a75-1b23-4e0e-9dee-12cf0739a55f"
}

The URL can be opened in a new tab as is.

If you redirect from your website to the web form, you need to append parameters to the URL, that inform the web form where to redirect to, after the bank login process is finalized or terminated.

URL	`https://webform-sandbox.finapi.io/wf/0cfb4a75-1b23-4e0e-9dee-12cf0739a55f`
Web Form ID for the URL	`0cfb4a75-1b23-4e0e-9dee-12cf0739a55f`
URL with Redirect Parameters	`https://webform-sandbox.finapi.io/wf/0cfb4a75-1b23-4e0e-9dee-12cf0739a55f?redirectUrl=https://www.yourapp.io/everythingfine&errorRedirectUrl=https://www.yourapp.io/somethingswrong&abortRedirectUrl=https://www.yourapp.io/cancel`

For more details on the redirect parameters refer to

https://documentation.finapi.io/webform/for-best-results#Forbestresults!-Enhanceend-userexperience!

Embed the Web Form into your Web Site

The web form is available as a web component. Details on how to integrate it into your webpage can be found in this section:

https://documentation.finapi.io/webform/embedded-web-form-2-0

Web Form Customization and White Labelling

If you want to adapt the web form’s look and feel to your website, you can follow the instructions:

https://documentation.finapi.io/webform/white-labeling

Web Form Error Handling

Errors in the finAPI web form front end executed in the user’s web browser may not necessary imply a failure in the bank login or a failed GiroIdent KYC check!

The client-application shall not bind it’s execution flow to the re-direct of the finAPI web-form front end (respectively the Javascript result callback events for the web-form web component).

The final KYC verdict shall be received from the GiroIdent API (or via a callback registered with the API) in any case (even for an error in the web from frontend execution), to ensure the best possible conversion rate for the KYC check.

In case of an error, that affected the KYC process, details are provided by the GiroIdent API!