Page Comparison

...

Determine your business case - would you like to use our Account Information Services or Payment Initiation Services? Based on the answer, check our openAPI documentation to understand which end point endpoint to use.

When the customer application is calling a finAPI Web Form 2.0 service defined here (either for Account Information Services or Payment Initiation Services) the API will respond with HTTP code 201, and the API response could look like below (example):

...

The API response will contain a URL to the Web Form to which you must direct your end-user. The general format is:

...

The rest of the interaction happens directly between the end-user and our Web Form. At the end of the workflow, depending on whether the customer application has set up a callbackUrl, we can explicitly notify the customer application of the end state.

Use this notfication notification to come back to us and ask for more details (paymentId in case of PIS and bankConnectionId in case of AIS)

...

1. Web Form token is a one-time token. You will be able to open the URL just once. Further attempts will result in an error page.

2. Web Form URLs are valid for just 20 minutes. If a Web Form is not consumed for its purpose within 20 minutes of initiation, it will expire.

3. The Web Form will consider the default language (supported languages: DE, EN, CZ and SK) of your browser and render accordingly. However, if your end-user prefers a different language than the browser, they are free to use the language picker in the header to select a different one. If they do, we will store their new language preference for all future Web Forms rendered to the user.

   1. ⚠ User’s language preference wont won't be stored (along with all other user data) in use cases where customers delete users after one - time use

   2. ⚠ As a customer, if you prefer all Web Forms to be rendered in only 1 language of your choice, please use our whitelabeling end point white labeling endpoint to set this up.

Want to know Web Form status?

...

• "NOT_YET_OPENED" - when the Web Form URL has not been accessed yet.

• "IN_PROGRESS" - when the Web Form page has been opened and the flow is in - progress.

• "COMPLETED" - when the Web Form has successfully executed the service.

• "COMPLETED_WITH_ERROR" - when the Web Form has been executed but something unexpected happened. Unsuccessful end state.

• "ABORTED" - when the user has aborted the Web Form flow (by clicking the CANCEL button at some step during the process)

• “EXPIRED” - this is an internally forced state when there are abandoned Web Forms in non-final states (COMPLETED, COMPLETED_WITH_ERROR or ABORTED are the only possible final states) for longer than 20 minutes.

...