Contents x
      Batch disbursements
      • 11 Oct 2024
      • Print
      • PDF
      Contents

      Batch disbursements

      • Updated on 11 Oct 2024
      • Print
      • PDF
      Article summary

      ⚠️ The pawaPay Dashboard Docs have moved home ⚠️

      Visit our new and improved Docs Hub here: docs.pawapay.io, and learn about ‘Batch disbursements’ here.


      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 in by you.

      ColumnDescription
      CountryThe country in which the recipient of the disbursement resides in.
      TelcoThe Mobile Network Operator (MNO) that the recipients mobile money wallet is registered with.
      CurrencyThe currency for this disbursement.
      MSISDNThe phone number of the recipient of this disbursement.
      Please note!
      The MSISDN should:
      • not start with a + sign
      • start with the country code
      AmountThe amount you wish to disburse.
      DescriptionThe description of this disbursement.
      Please note!
      The description should:
      • Be at least 4 characters
      • Not be longer than 22 characters
      • Contain only characters and numbers
      • Not contain any special characters


      Please note!
      You can find all the supported Country, Telco and Currency combinations from our API docs.

      Example batch disbursement file


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

      Uploading your batch disbursement file

      After filling your file you can proceed to upload it into our system for validation. Your file will validated for formatting errors and that your account has configuration in place to disburse to the specified MNOs. 

      The results of validation will be shown directly in the dashboard.

      ResultDescription
      ReadyThe transaction is ready to be disbursed.
      FailedTransaction is not valid. You can hover on the transaction to see the failure reason.

      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.

      Please note!
      You can 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.

      Initiating the batch disbursements

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


      Was this article helpful?