Create a link intent
Creates a link intent, the first step to connect an account through the Fintoc widget. The response includes the widget_token needed to initialize the widget; Fintoc returns the token only in this response. The link intent inherits the live or test mode of the API key used.
v1 · Base URL https://api.fintoc.com/v1Authorizations
Body
ISO 3166-1 alpha-2 code of the country of the institution to connect.
cl "cl"
Whether the credentials to connect belong to an individual or a business.
individual, business "business"
Fintoc product that the resulting link will be used for.
movements "movements"
Response
Link intent created. The widget_token is only returned in this response.
Unique identifier of the link intent.
"li_a6WUojQ2SjSSeFjH"
Type of the object. Always link_intent.
ISO 3166-1 alpha-2 code of the country of the institution to connect.
cl "cl"
ISO 8601 timestamp of when the link intent was created.
"2022-12-01T01:50:12Z"
Token used to retrieve the resulting link from your backend once the link intent succeeds. Only returned by the widget when the connection succeeds; null in every other response.
"li_a6WUojQ2SjSSeFjH_exc_Q802GD8ZLmMuK0Atl4ucJuLp"
ISO 8601 timestamp of when the exchange_token expires. null if no exchange token has been issued.
"2022-12-01T02:50:12Z"
Whether the credentials to connect belong to an individual or a business.
individual, business "individual"
Mode of the link intent. live connects to real institutions, test connects to the test institution with fake data.
live, test "live"
Fintoc product the resulting link will be used for.
movements "movements"
Status of the link intent. rejected means the institution rejected the credentials, failed means an error kept the connection from completing.
created, in_progress, succeeded, failed, rejected "created"
Token used to initialize the Fintoc widget for this link intent. Only returned when the link intent is created; null in every other response.
"li_a6WUojQ2SjSSeFjH_sec_Q802GD8ZLmMuK0Atl4ucJuLp"