Skip to main content
All CollectionsPaymentsManaging beneficiaries
Adding multiple beneficiaries at once with a file upload
Adding multiple beneficiaries at once with a file upload
François Cosnier avatar
Written by François Cosnier
Updated over a month ago

Do you have dozens or even hundreds of beneficiaries to pay with iBanFirst? You can easily add multiple beneficiaries at once using a single file upload.


Steps to upload beneficiaries

Navigate to Beneficiary Bulk Upload

Go to Payments > Beneficiaries > Actions (the "..." icon) > Beneficiary bulk upload.

Download the import file format provided, and fill it in with the beneficiaries you wish to add.


File preparation guidelines

- General instructions:

  • Do not modify column titles or change the column order.

  • Save the file in semi-colon-separated CSV format.

  • Ensure that all mandatory fields are filled in; optional fields can be left empty.

- Required fields:

  • beneficiary_name: Free text for the account holder's name.

  • account_number_iban: Must contain the account number, which can be either an IBAN or a free-format account number.

  • currency: Must be in 3-digit ISO format (e.g., EUR, USD, GBP).

  • beneficiary_bank_bic_code: Must contain the beneficiary’s bank BIC/SWIFT code.

  • intermediary_bank_bic_code: Optional; can contain the intermediary’s BIC/SWIFT code to facilitate payment routing.

  • beneficiary_type: Mandatory; can be either "corporate" or "individual" (case-sensitive).

  • beneficiary_country: Must be in 2-letter ISO format (e.g., FR for France, US for the USA, CN for China).

  • email_address: Optional; can be used for sending payment notification emails.

  • alias: Optional; can be used to assign an alias to a beneficiary for easier identification.

  • category: Optional; can categorize beneficiaries as "Employee," "Supplier," or "Treasury" (case-sensitive).

  • address: Optional; can include the beneficiary’s address.

  • zip_code: Optional; can include the beneficiary’s zip code.


Upload and import

Once the file is filled out and verified, upload it. A preliminary check will exclude any invalid rows and beneficiaries.

Click Import beneficiaries to add the valid entries.

You will receive an email notification once the beneficiaries have been added, and you will be able to pay them immediately after.

This process streamlines the addition of multiple beneficiaries, saving you time and effort.

Did this answer your question?