Bulk transfers endpoint errors

You can provide a bulk transfers feature to your users by using the "Send bulk transfers" 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 to add in the body an array of transfers, a transfer being:

  • a beneficiary name
  • an IBAN
  • an amount in euro
  • a label (optional)

Mandatory fields and format verifications

To avoid issues when initiating the transfers with the bank, we proceed to several verifications before redirecting your user to the Bridge Transfer funnel. If the array contains some errors, we will list the errors like this:

{
    "errors": [
        {
            "code": "bulktransfer.invalid_beneficiary_iban",
            "property": "transfers[0].beneficiary.iban",
            "message": "Beneficiary IBAN is invalid"
        },
        {
            "code": "bulktransfer.amount_not_allowed",
            "property": "transfers[1].amount",
            "message": "Amount value is not allowed. It cannot be superior to 30000€"
        }
    ]
}

Here is the complete list of errors you can get:

Code

Property

Message

bulktransfer.invalid_beneficiary_iban

transfers[i].beneficiary.iban

Beneficiary IBAN is invalid

bulktransfer.amount_not_allowed

transfers[i].amount

Amount value is not allowed. It cannot be superior to 30000€

bulktransfer.label_wrong_format

transfers[i].label

Label has wrong format or is too long

bulktransfer.capability_missing

/

Your account doesn't have the capability to perform this operation: BULK_TRANSFER

bulktransfer.max_number_of_transfers

transfers

A bulk transfer cannot contain more than 400 transfers

bulktransfer.max_number_of_transfers_specific

transfers

You are allowed to initiate {max} transfers maximum in one time (this limit comes from your bank). Please reduce the number of transfers to initiate and start again.

bank.unsupported_capability

/

The selected bank does not support [capability name], please try with another bank

If a mandatory field is missing, you will get a 400 bad request response:

{
    "type": "invalid_request",
    "message": "Invalid body content",
    "documentation_url": null
}

Items, accounts and statuses verifications

We also process verifications on the user's items and accounts. Here is the list of the cases and messages you will get when the user's items or accounts don't allow us to initiate transfers:

Case

Message

The sender account provided does not exist

Please provide a correct sender_account_id

The item's status linked to the sender account you provided does not allow us to initiate transfers (item's status must be 0 or 1009)

Your account status does not allow to initiate a transfer. Please synchronize your account again before trying to initiate transfers

None of the user items' statuses allow us to initiate transfers (the user must have at least one item with status 0 or 1009)

Your accounts statuses do not allow to initiate a transfer. Please synchronize one of your accounts again before trying to initiate transfers

The user does'nt have any items

You haven't synchronized any item yet. Please synchronize an item before trying to proceed to batch transfers

The user doesn't have any account compatible with bulk transfers

You do not have any account compatible to initiate transfer


Did this page help you?