Introduciendo actualización on demand

Actualmente, los movimientos bancarios que devuelve la API de Fintoc se actualizan cada una hora para las conexiones que son recurrentes. Cada vez que vemos un movimiento nuevo te enviamos un webhook para notificarte de manera proactiva cualquier actualización en la información bancaria.

Aún así, hay casos donde el usuario final necesita tener esta información actualizada en el minuto que está visitando tu aplicación para mejorar la experiencia de usuario.

Por ejemplo, un usuario que se acaba de comprar un café y abre en ese instante su aplicación de finanzas personales para revisar cómo cambió su presupuesto del mes. O un contador de una empresa que está conciliando las facturas a fin de mes y quiere hacer ese trabajo apenas abre la vista.

Por eso, creamos un nuevo endpoint en la API para que puedas hacer actualizaciones on demand, así Fintoc va a actualizar tus movimientos bancarios cuando no hayamos refrescado los movimientos en un tiempo.

¿Cómo funciona la actualización on demand?

Agregamos 3 nuevos endpoints en la API Fintoc:

	POST /v1/refresh_intents
Crear un refresh intent on demand, “quiero que actualices mi cuenta”. 
	GET /v1/refresh_intents
Obtener una lista con los últimos refresh intents.
	GET /v1/refresh_intents/{id}
Ver el detalle de algún refresh intent.

Con eso podrás solicitar la actualización on demand de tus links.

¿Cómo lo hago?

  1. Envía un post request a la URL, indicando el link token del link que quieres actualizar:
POST https://api.fintoc.com/v1/refresh_intentslink_token=link_72DQoGNWimkdxypA_token_Nv******Wke_htuY5_g

2. Recibirás como respuesta el refresh intent creado.

{
    "id": "ri_AbzeNONZSgR0y210",
    "requires_mfa": null,
    "object": "refresh_intent",
    "refreshed_object": "link",
    "refreshed_object_id": "link_72DQoGNWimkdxypA",
    "status": "created",
    "created_at": "2021-10-15T16:18:08.813Z",
    "type": "only_last"
}


3. Recibirás un webhook contándote que la cuenta ya fue actualizada 🎉🎉🎉

{    
    "id": "evt_PQqpnZXACM0EVg2G",
    "type": "account.refresh_intent.succeeded",
    "mode": "live",
    "created_at": "2021-10-14T19:16:08.158Z",
    "data": {
       "type": "only_last",
       "object": "refresh_intent",
       "status": "succeeded",
       "created_at": "2021-10-14T19:16:07.155Z",
       "new_movements": 0,
       "refreshed_object": "account",
       "refreshed_object_id": "acc_L59JzlRVT8elME1V"
	},   
	"object": "event"
}


Este proceso puede llevar algunos minutos dependiendo de cada banco.

Agregamos la variable new_movements para verificar cuantos movimientos nuevos se detectaron con ese refresh, así que si es cero, no hubo nuevos movimientos.

Para hacer refresh on demand es importante tener en cuenta algunos puntos:

  1. Que no haya otro refresh_intent en progreso.
  2. Debes esperar al menos 45 minutos entre cada solicitud

¿Cómo activo esta feature?

Puedes probar nuestro ambiente sandbox completamente gratis siguiendo nuestra documentación, y si quieres activarlo en producción para tu cuenta solo envíanos un correo a [email protected].