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:

CodeMessage
transferrequest.sender_account_not_foundPlease provide a correct sender_account_id
transferrequest.invalid_sender_accountYour 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_accountYou do not have any account compatible to initiate transfer
transferrequest.no_valid_sender_accountYour 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_attemptsToo many wrong password attempts on this account, try again later.
transferrequest.invalid_ibanIBAN is invalid
transferrequest.beneficiary_name_too_longBeneficiary name has wrong format or is too long (35 characters max)
transferrequest.label_too_longLabel has wrong format or is too long ({max} characters max)

(different for each bank)
transferrequest.amount_positiveAmount must be greater than 0
transferrequest.invalid_client_referenceclient_reference field is invalid or empty (36 characters max, letters, digits and dashes only)