El objeto Link
UnLink representa la conexión entre un usuario final y una institución financiera. Esta conexión otorga acceso a las cuentas bancarias que el usuario tiene en esa institución. Fintoc crea el Link cuando el usuario completa el flujo del Fintoc Widget. El Link agrupa los objetos Account asociados y su estado de actualización.
Link Object
{
"id": "link_nMNejK7BT8oGbvO4",
"object": "link",
"accounts": [
{
"id": "acc_Z6AwnGn4idL7DPj4",
"object": "account",
"balance": {
"available": 7010510,
"current": 7010510,
"limit": 7510510
},
"currency": "CLP",
"holder_id": "111111111",
"holder_name": "Test Customer 1",
"name": "Cuenta Corriente",
"number": "0000000000",
"official_name": "Cuenta Corriente Moneda Local",
"type": "checking_account"
},
{
"id": "acc_BO381oEATXonG6bj",
"object": "account",
"balance": {
"available": 500000,
"current": 500000,
"limit": 500000
},
"currency": "CLP",
"holder_id": "111111111",
"holder_name": "Test Customer 1",
"name": "Línea de Crédito",
"number": "00000000000",
"official_name": "Linea De Credito Personas",
"type": "line_of_credit"
}
],
"active": true,
"created_at": "2020-04-22T21:10:19.254Z",
"holder_id": "111111111",
"holder_type": "individual",
"institution": {
"id": "cl_banco_de_chile",
"country": "cl",
"name": "Banco de Chile"
},
"last_time_refreshed": "2020-04-22T23:10:19.254Z",
"link_token": "link_nMNejK7BT8oGbvO4_token_GLtktZX5SKphRtJFe_yJTDWT",
"mode": "test",
"refresh_status": "refreshing",
"status": "active",
"username": "111111111"
}
Link incluye los siguientes atributos:
| Atributo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del Link. |
object | string | Identificador del tipo de objeto. Siempre es link. |
accounts | array | Cuentas asociadas al Link. Consulta el Objeto Account para obtener más detalles. Fintoc incluye este campo cuando intercambias un link_token o consultas un Link; devuelve null cuando listas objetos Link. |
active | boolean | Si es true, las cuentas bancarias del Link se están actualizando. |
created_at | string | Fecha y hora de creación del Link en formato ISO 8601 y UTC. |
holder_id | string | Identificador del titular de las cuentas asociadas al Link. En Chile, es el identificador tributario chileno (RUT). En México, es el Registro Federal de Contribuyentes (RFC). |
holder_type | string | Tipo de titular de la cuenta: individual para personas naturales o business para empresas. |
institution | object | Institución financiera asociada al Link, identificada por id, country y name. |
last_time_refreshed | string | Fecha y hora de la actualización más reciente del Link y sus cuentas, en formato ISO 8601 y UTC. |
link_token | string | Token para solicitar recursos anidados bajo un Link, como movimientos bancarios. Fintoc solo devuelve este atributo al crear un Link. En respuestas posteriores, este campo siempre es null. |
mode | string | Modo del Link: live o test. Usa test para el sandbox. |
refresh_status | string | Estado de actualización del Link: idle, refreshing, partially_refreshing o interrupted. |
status | string | Estado operativo del Link: active si se actualiza sin problemas, login_required si necesita una reconexión o inactive si fue desactivado. |
username | string | Nombre de usuario para la plataforma del banco. En Chile, siempre es un RUT. |