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)


Did this page help you?