Saltar al contenido principal
POST
Create a link intent
v1 · Base URL https://api.fintoc.com/v1

Autorizaciones

Authorization
string
header
requerido

Cuerpo

application/json
country
enum<string>
requerido

ISO 3166-1 alpha-2 code of the country of the institution to connect.

Opciones disponibles:
cl
Ejemplo:

"cl"

holder_type
enum<string>
requerido

Whether the credentials to connect belong to an individual or a business.

Opciones disponibles:
individual,
business
Ejemplo:

"business"

product
enum<string>
requerido

Fintoc product that the resulting link will be used for.

Opciones disponibles:
movements
Ejemplo:

"movements"

Respuesta

Link intent created. The widget_token is only returned in this response.

id
string
requerido

Unique identifier of the link intent.

Ejemplo:

"li_a6WUojQ2SjSSeFjH"

object
any
requerido

Type of the object. Always link_intent.

country
enum<string>
requerido

ISO 3166-1 alpha-2 code of the country of the institution to connect.

Opciones disponibles:
cl
Ejemplo:

"cl"

created_at
string<date-time>
requerido

ISO 8601 timestamp of when the link intent was created.

Ejemplo:

"2022-12-01T01:50:12Z"

exchange_token
string | null
requerido

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.

Ejemplo:

"li_a6WUojQ2SjSSeFjH_exc_Q802GD8ZLmMuK0Atl4ucJuLp"

exchange_token_expires_at
string<date-time> | null
requerido

ISO 8601 timestamp of when the exchange_token expires. null if no exchange token has been issued.

Ejemplo:

"2022-12-01T02:50:12Z"

holder_type
enum<string>
requerido

Whether the credentials to connect belong to an individual or a business.

Opciones disponibles:
individual,
business
Ejemplo:

"individual"

mode
enum<string>
requerido

Mode of the link intent. live connects to real institutions, test connects to the test institution with fake data.

Opciones disponibles:
live,
test
Ejemplo:

"live"

product
enum<string>
requerido

Fintoc product the resulting link will be used for.

Opciones disponibles:
movements
Ejemplo:

"movements"

status
enum<string>
requerido

Status of the link intent. rejected means the institution rejected the credentials, failed means an error kept the connection from completing.

Opciones disponibles:
created,
in_progress,
succeeded,
failed,
rejected
Ejemplo:

"created"

widget_token
string | null
requerido

Token used to initialize the Fintoc widget for this link intent. Only returned when the link intent is created; null in every other response.

Ejemplo:

"li_a6WUojQ2SjSSeFjH_sec_Q802GD8ZLmMuK0Atl4ucJuLp"