Page Comparison

...

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 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 Web Forms to be rendered in only 1 language of your choice, please use our whitelabeling end point to set this up.

Want to know

...

Web Form status?

The endpoint to the “Get a web form” service is: GET /api/webForms/{id}

GET .../api/webForms/<webFormId that was contained in the message field of the initial service response> 
(For this example: GET .../api/v1/webForms/e0337037-1228-4db7-bcdb-32b0c5f64af4)

Querying a web form Web Form will give you the following result:

{
  "id": "e0337037-1228-4db7-bcdb-32b0c5f64af4",
  "url": "https://webform-sandbox.finapi.io/wf/e0337037-1228-4db7-bcdb-32b0c5f64af4",
  "createdAt": "2021-03-09T08:36:15.000+0000",
  "expiresAt": "2021-03-09T08:56:15.000+0000",
  "type": "STANDALONE_PAYMENT",
  "status": "COMPLETED",
  "payload": {
    "paymentId": 22718
  }
}

The id is the generated web form Web Form ID. It is also contained in the URL and used as an access token.

...

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

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

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

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

• "ABORTED" - when the user has aborted the web form 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 Web Forms in non-final states (COMPLETED, COMPLETED_WITH_ERROR or ABORTED are the only possible final states) for longer than 20 minutes.

Note that the “Get a web form” service is a user-related service, meaning that you have to pass an Authorization header with the user's access token, just as with any other of finAPI's user-related REST services. You might want to think about adding some user identifier to the callbacks.finalised or redirectUrl to be able to resolve the user context in your application in order to get hold of an appropriate access token (For security reasons, you should never include an access token itself in the web form Web Form URL)

How to test the Web Form Flow using openAPI?

As of now, openAPI will not automatically open the web form Web Form for you. You'll have to enter the web form Web Form URL into a separate tab of your browser yourself, and also have to call the “Get a web form” service for yourself once the web form Web Form has triggered the callback and/or redirect.