Errors

You can't create a Refresh Intent when there is another one in progress

If you create a Refresh Intent when there is another one in progress, you will receive an error looking like this:

{
    "error": {
        "type": "invalid_request_error",
        "message": "There is already a refresh intent in progress for link_00000000.",
        "code": "refresh_intent_in_progress",
        "param": null,
        "doc_url": "https://docs.fintoc.com/reference/errors"
    }
}

You have to wait 5 minutes to create a new Refresh Intent

If you created a Refresh Intent less than 5 minutes ago and it was successful, you will receive an error looking like this:

{
    "error": {
        "type": "invalid_request_error",
        "message": "This Link was recently refreshed.You have to wait at least 5 minutes between refresh intents",
        "code": "rate_limit_exceeded",
        "param": null,
        "doc_url": "https://docs.fintoc.com/reference/errors"
    }
}

📘
If you created a Refresh Intent less than 5 minutes ago and it failed, you can create another one without waiting.

The credentials are invalid

If we confirm that the credentials you're trying to use are invalid, you will receive an error looking like this:

{
    "error": {
        "type": "link_error",
        "message": "The institution indicated that the credentials are invalid. You need to reconnect the account.",
        "code": "rejected_refresh_intent"
    }
}

If we still haven't confirmed that the credentials you're trying to use are invalid but the bank recently said that they are invalid, you will receive an error telling you to wait some time looking like this:

{
    "error": {
        "type": "link_error",
        "message": "The institution indicated that the credentials are invalid. You have to wait at least an hour to avoid locking your credentials",
        "code": "rejected_refresh_intent"
    }
}