Single transfer endpoint errors

You can provide a single transfer feature to your users by using the "Send transfer" endpoint.

To use the feature, your user has to synchronize at least one item with at least one compatible account.

To call this endpoint, you need at least to include in your body:

a beneficiary
with a name
and an IBAN

Format verifications and error responses

To avoid issues when initiating the transfer with the bank, we proceed to several verifications before redirecting your user to the Bridge Transfer funnel. If the body contains some errors, we will response an error like this:

{
    "errors": [
        {
            "code": "transferrequest.sender_account_not_found",
            "message": "Please provide a correct sender_account_id"
        }
    ]
}

Here is the complete list of errors you can get:

Code	Message
transferrequest.sender_account_not_found	Please provide a correct sender_account_id
transferrequest.invalid_sender_account	Your account status does not allow to initiate a transfer. Please synchronize your account again before trying to initiate transfers (if you provide a sender account id which cannot initiate transfers)
transferrequest.no_sender_account	You do not have any account compatible to initiate transfer
transferrequest.no_valid_sender_account	Your accounts statuses do not allow to initiate a transfer. Please synchronize one of your accounts again before trying to initiate transfers (if you don't provide a sender account id and none of the user's accounts can initiate transfers)
transferrequest.too_many_failed_attempts	Too many wrong password attempts on this account, try again later.
transferrequest.invalid_iban	IBAN is invalid
transferrequest.beneficiary_name_too_long	Beneficiary name has wrong format or is too long (35 characters max)
transferrequest.label_too_long	Label has wrong format or is too long ({max} characters max) (different for each bank)
transferrequest.amount_positive	Amount must be greater than 0
transferrequest.invalid_client_reference	client_reference field is invalid or empty (36 characters max, letters, digits and dashes only)