ResourcesError handlingError codes

007101

Error messageTransfer authentication failed. Please retry with a new request.
DescriptionThe 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:

1{
2    "Id": "xfer_c_01JRSHQFG2337DBQ4NS8XPYCK7",
3    "CreationDate": 1744614179,
4    "DebitedWalletId": "wlt_m_01JRJM7ASZN7YP4MBDVBT0HZF1",
5    "CreditedWalletId": "wlt_m_01JRHSTW2NP4MDB45WQMDNS23C",
6    "AuthorId": "user_m_01JRJM5RR5NYQDN0S6QWJJDRMR",
7    "CreditedUserId": "user_m_01JRHSS3B18H86QA0C467RVK07",
8    "DebitedFunds": {
9        "Currency": "EUR",
10        "Amount": 3001
11    },
12    "CreditedFunds": {
13        "Currency": "EUR",
14        "Amount": 3001
15    },
16    "Fees": {
17        "Currency": "EUR",
18        "Amount": 0
19    },
20    "Type": "TRANSFER",
21    "Nature": "REGULAR",
22    "Status": "FAILED",
23    "Tag": "Created using Mangopay API Postman Collection",
24    "ResultCode": "007101",
25    "ResultMessage": "Transfer authentication failed. Please retry with a new request.",
26    "ExecutionDate": null,
27    "PendingUserAction": null
28}