Skip to main content
You can use our Batch disbursements page to initiate multiple disbursements at the same time directly from our dashboard. This functionality is available to users with the Batch Disbursements role. Read more about User roles.

​
Creating your batch disbursements file

You can download a template directly from the dashboard to create a new batch disbursement file.
The template contains the following columns to be filled out by you.
The MSISDN must:
  • not start with a + sign
  • start with the country code
The description must:
  • Be at least 4 characters
  • Not be longer than 22 characters
  • Contain only letters, numbers and spaces
  • Not contain any special characters
You can find all the supported Country, Telco, and Currency combinations from our API docs.

​
Example batch disbursement file

A maximum of 1000 disbursements can be added to a single batch disbursement file.

​
Uploading your batch disbursement file

After filling in your file, you can proceed to upload it into our system for validation. Your file will be validated for formatting errors and to ensure your account has configuration in place to disburse to the specified MMOs. The results of validation will be shown directly in the dashboard.

​
Fixing validation failures

When encountering failures in your batch disbursement file, you can press the “Download Results” button to retrieve your batch disbursement file together with the failure reasons. You can fix the errors in this file and attempt to upload again.
You can re-upload the file downloaded by pressing the “Download Results” button to attempt again.You do not need to remove the failure reasons from this file before re-uploading.

​
Initiating the batch disbursements

If every transaction is “Ready”, you can press the “Schedule payment” button to initiate the disbursements.