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:

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: