Creates a refresh intent for a link, using the link's link_token to authenticate the request. Unless the institution requires multi-factor authentication, the refresh starts asynchronously and Fintoc notifies the result through webhooks. Your organization needs the on demand refresh policy, and Fintoc rate limits consecutive refreshes (5 minutes between only_last refreshes, 60 minutes between historical ones).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Fintoc will update your accounts and notify you with the results through the webhook system.
When the update is completed successfully, you will receive the event account.refresh_intent.succeeded. After that, you can immediately request the Fintoc API for the newest bank movements.
When the update fails or the bank indicates that the credentials are invalid, you will receive the events account.refresh_intent.failed and account.refresh_intent.rejected respectively.
Some restrictions exist to request an on-demand update. For example, you can't create a Refresh Intent if there is another one in progress. Also, if the refresh_type is of type only_last you must wait five minutes between Refresh Intents. If the refresh_type is of type historical you must wait sixty minutes between Refresh Intents.