QWqwist
Customizable Widget

Manual synchronization

Changed on

Initiate a manual synchronization flow to fetch new data (e.g. transactions) for already connected accounts from the respective bank(s).

post/ongoing/sync

Request

Request body

statestring

A client-provided identifier that helps track a specific user's journey through the widget flow. When you initially create the widget session, you can set this value to any string that helps identify the user's context (e.g., a session ID, user ID, or transaction reference). When the user completes their interaction and is redirected back to your redirect_uri, this same state value is returned as a query parameter. This mechanism allows you to securely match the returning user with their original session and maintain context about who they are and what they were doing, particularly important in scenarios with multiple concurrent widget sessions.

redirect_uristring url required

The URL where users will be redirected after completing their interaction with the Widget.

The redirect includes the following query parameters:

  • state: Your original state value passed during initialization
  • success: Boolean indicating whether the flow completed successfully
  • cancel: Boolean indicating if the user canceled the flow (only present when canceled)
  • code: Authorization code valid for 1 hour, used to obtain an access token (only present on successful completion)
  • flow_id: Unique identifier for accessing flow-specific resources
  • failed_rules: Comma separated list of rules which failed in the verification step. Only present on the Verify and Pay flow
languageLanguage (unresolved $ref)
market'at' | 'be' | 'de' | 'demo' | 'dk' | 'es' | 'fi' | 'fr' | 'it' | 'nl' | 'no' | 'pt' | 'se'

The market used to customize provider selection in the Widget UI. This pre-selects the default providers shown as quick-pick tiles and restricts provider search results strictly to the specified country (or demo environment). If omitted, defaults to de.

account_idsstring[] required

List of accounts to be synchronized. In case the list contains accounts which belong to different banks, the user will be guided through multiple synchronization processes.

user_idstring email required

The email address of the user for which you want to synchronize the accounts provided in the account_ids field. This email address has to be the same as you specified during the initial ongoing synchronization flow.

Response

Widget link created

locationstring url required

The location of the Widget UI to which the user should be directed. The location includes the WidgetToken as query parameter.

idstring uuid required

ID of the created WidgetLink

Example response

{
  "location": "https://finx.finleap.cloud/?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJoYWhhIjoiaSBtYWRlIHlvdSBsb29rIn0.jk1WqP6S28bNuP5MwwlZHR_5GlksWsEZPMztWUAIiJY",
  "id": "3ca31c37-986a-454e-ad64-8e97143c86bc"
}

Changes