Skip to main content
When you request a Refresh Intent, the update isn’t immediate. Fintoc first needs to go to the bank to search for new movements and the time that can take depends on the bank and its conection status, but it normally takes between 1 and 3 minutes. So you don’t need to ask if the update is finished every 5 seconds, you should create a Webhook Endpoint, where we will notify you through an Event when the Refresh Intent has been completed. For each account in your Link, we will send you an event. For example, if your Link has three accounts, you will receive three events, each one containing the result of each account update. Keep in mind that the three results could be different, and the Refresh Intent will be marked successful only if every account gets successfully updated.

​
If everything goes right

If the update goes according to planned when refreshing an account, we will send you an account.refresh_intent.succeeded event that looks like this:
Inside the data key, you will find the detail about the refresh. In this case, the account with id: acc_00000000 got successfully updated, as its status is succeeded. The new_movements field indicates how many new movements were found during the update. If this number is different to zero, you should query the List Movements endpoint to obtain the new movements. If that number is zero, you can assume that you have the latest movements already.
On demand, recurrent and the new_movements fieldThe new_movements field refers to the amount of movements new after the update, and not since you last called the API, so you must be careful if your account also has recurrent updates, as the new_movements of a refresh may not be the amount of new movements since you last requested movements to Fintoc.

​
If something goes wrong

If the update fails, for example if the bank application is down, we will send you an account.refresh_intent.failed event.
Inside data, the account with id: acc_00000001 has status: failed. If public_error is retryable_error, check the API response before retrying because a waiting period may still apply. If public_error is support_required_error, contact support.

​
If the credentials are invalid

If the update fails because the credentials are invalid, we will send you an account.refresh_intent.rejected event:
Inside data, the account with id: acc_00000002 has status: rejected because the bank rejected its credentials. The API may block another request while Fintoc checks the credentials or during a waiting period. Check the API response before retrying. Repeated attempts can lock the account holder out of the bank account.
Invalid credentialsSometimes, banks say a set of credentials are invalid when they are not. For this reason, Fintoc lets you retry the Refresh Intent after a rejected status. If the credentials are invalid, reconnect the Link. See Reconnect a Link.