007101
Error message | Transfer authentication failed. Please retry with a new request. |
---|---|
Description | The user reached the maximum number of retries for one of the authentication factors, so the SCA session failed. |
Categories | Transfers SCA |
Causes
This error occurs when a transfer is attempted and SCA is required, but the SCA session fails because the user has unsuccessfully attempted to authenticate a factor too many times.
SCA is required on Transfers between two users with the UserCategory
of OWNER
. On existing integrations, this is indicated by setting ScaContext
to USER_PRESENT
in the request. Read more about SCA on transfers.
If the SCA session fails, the Transfer’s Status
changes from CREATED
to FAILED
.
What to do
In this scenario, you can retry the Transfer to generate a new SCA session that the user can authenticate. If the user needs to reset one of their factors, they have this option during the session. Read more about SCA factors.
Ensure your integration relies on transfer webhooks to know the outcome of SCA.
Example
Example of the failed transfer retrieve using GET View a Transfer: