Skip to main content
Skip table of contents

Fiat batch payments

Overview

Batch payments enable individuals and companies to execute multiple payment transactions in a single operation, significantly simplifying large-volume transactions. This feature supports multiple fiat currencies along with SEPA, SWIFT, and local payment methods.

Currently, the batch payments functionality is not incorporated in the Admin Panel. Instead, it is available through the Web Interface. The Admin Panel only displays the record of transaction creation and their processing following batch payment approval.

Configuring access roles

Before working with batch payments, ensure that the permissions for the access roles of the involved client profiles are properly set.

To set the permissions for an access role, perform the steps below:

  1. In the Admin Panel, navigate to Banking > Access roles;

  2. Select a role and click Edit;

  3. Navigate to the Client batch transfer item and check the desired permissions;

  4. Click the Update button to save the changes.

See Access roles for more detail.

Creating a batch payment

To create a batch payment, follow the steps below:

  1. In the Web Interface, navigate to the Payments & transfers > Batch section.

  2. Click the Add new tab.

  3. On the Upload Batch screen, select an account from the list of available accounts and a payment method that is supported by the selected account.

  4. Click Download .csv template to download the CSV file on your machine. The template contains all the necessary fields that you need to fill in to perform the payment. For more information on the template, see the CSV template details subsection.

  5. On your machine, fill in the payment information for every individual transaction in the corresponding fields of the template and save the changes. Rename the CSV file if necessary.

  6. Once you’ve filled in all the payment information, navigate back to the Upload Batch screen and either click Select .csv file to upload or simply drag and drop the file in the upload box. The file will appear as a separate item under the upload box.

  7. Click the Upload button to complete the uploading of a template. A dialog confirming that files have been uploaded successfully will appear.

As a result, the batch payment will appear in the table on the All tab. All newly created batch payments have the Waiting for approval status.

For more information on statuses, see the Checking the status of a batch payment subsection.

Approving a batch payment

To approve a batch payment, follow these steps:

  1. In the Web Interface, navigate to the Payments & transfers > Batch section.

  2. In the table on the All tab, click the Details button of the batch payment that you want to approve.

  3. On the appeared screen with all the separate payments included in the batch payment perform one of the following actions:

  • To approve a batch payment, click Approve: The batch payment will have the Processing status.

  • To decline a batch payment, click Decline: The batch payment will have the Rejected status.

When the approved batch payment is completed, it will change its status from Processing to Completed. Once it’s completed, you can see all payments included in the batch as separate transactions in the Dashboard.

Please note that a batch will have the Completed status even though some of its transactions were declined while processing. For instance, after approving a batch, if 99 transactions out of 100 are successfully processed, while 1 transaction is declined, the status of the batch payment will be Completed. The same rule applies to situations with insufficient funds in the account: Transactions will be carried out until the funds run out, and the remaining transactions will not be processed, while the batch payment will have the Completed status. For more information on statuses, see the Checking the status of a batch payment subsection.

Checking the status of a batch payment

You can check the current status of a batch payment directly in the table on the All tab of the Batch section. For more information on each status, click the details button of a batch payment in the table.

The concept of the batch payment status refers to the state of transactions. For example, if a transaction is either completed or declined, it is in its final state, while other states are considered to be non-final ones. In this respect, a batch payment containing only transactions in the final state is considered to be completed. See Transactions for more detail.

The following are all possible statuses that a batch payment can have:

Status name

Description

Completed

This status implies one of the following states:

  • All transactions included in the batch are completed.

  • At least one transaction included in the batch is completed, other transactions are declined.

  • All transactions included in the batch are declined.

Waiting for approval

The batch payment is ready to be approved.

Rejected

The batch payment is declined.

Validation failed

The batch payment CSV file contains recipient information that cannot be validated.

Processing

The payments included in the batch are being processed.

For more detail on error handling, see the Handling issues subsection.

Handling issues

If there's an issue with a batch payment, the Web interface will either show an error message detailing the issue or the corresponding batch payment status. Common issues include, for example, invalid template format and invalid recipient details. 

Here are some of the most common issues:

  • Invalid template format: If the payment details file format is changed from CSV to any other, the file will not be loaded, and the corresponding error message will appear in the Web Interface. Change the format of the file to CSV to upload it successfully.

  • Invalid recipient details: If the batch payment details contain information that cannot be validated, the batch payment will have the Validation failed status. Check the CSV file with batch payment details for errors on your machine, make necessary corrections, save the file, and upload it again.

  • Insufficient funds: In this case, transactions are carried out until the funds run out, the remaining transactions will not be processed, and the batch payment will have the Completed status. Top up your account and upload a new CSV file with those payments that were not processed.

CSV template details

Typically, a CSV template for a batch payment includes the following fields:

Field name

Description

Amount

The total amount of money to be transferred in the payment.

Currency

The currency in which the payment amount is denominated.

Beneficiary type

The type of the beneficiary. Can be a person or a company.

Recipient’s bank name

The name of the recipient's bank where the payment will be deposited.

Recipient’s bank address

The physical address of the recipient's bank.

Recipient’s bank country

The country in which the recipient's bank is located.

IBAN / Account Number / CLABE

The recipient's International Bank Account Number (IBAN), Account Number or CLABE (Clave Bancaria Estandarizada) for banks in Mexico.

SWIFT / BIC

The Bank Identifier Code (BIC) or SWIFT code of the recipient's bank.

Recipient name

The name of the person or the company that will receive the payment.

Beneficiary address

The physical address of the beneficiary.

Beneficiary city

The city in which the beneficiary is located.

Beneficiary state

The state in which the beneficiary is located.

Beneficiary postal code

The postal code of the beneficiary's location.

Beneficiary country

The country in which the beneficiary is located.

Description

A brief description or reference for the payment. This could be an invoice number, an internal reference code, or a short note about the purpose of the payment.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.