Peach payments enable businesses to make bulk EFT payments, Example usage could be to pay out, suppliers, partners, employees or customers who paid for goods and services via EFT, and need to be refunded.


Please see our documentation hub which contains copyable snippets with additional code snippets.

 
Payouts can be used in two ways


1. Manual upload of CSV information

2. API requests to submit batch payouts

With both methods, you would need to either maintain some funds (float) that we debit on each batch request, or make a transfer for the total amount that needs to be paid out.


How to use PayOuts?


To process a PayOuts batch a few steps are required, which are described below. To get access to the PayOuts portal and your API credentials, please send an email to support@peachpayments.com


1. Upload a PayOuts batch

You can upload a batch with recipients to be paid out via API or via a CSV upload

You can specify one of the two Service Types in your upload:

  • SDV service means that the batch is released for processing on the action date and recipients will receive their funds from the evening onwards, taking into account inter-bank delays.
  • 1Day service; payouts are released for processed on the chosen date at midnight, and recipients will receive payment at the same time, on the specified action date, regardless of the bank they bank with.

    So if for example, you set up a 1Day service batch on the 29th with action date the 30th, payments will be processed to recipients accounts midnight on the 29th to reflect the morning of the 30th


After a batch is uploaded a Check Digit Verification (CDV) will be performed to check on account validity of every payout. Passing this test does not necessarily mean that the bank account is valid and open. However, failing it does mean there is no such an account (click here for more info about the CDV)


It is recommended to use the list of universal bank branch codes to avoid errors like incorrect branch codes, non-existent branch codes, etc. You can find the list here; List Of Universal Branch Codes - SA.


It is strongly recommended to do a Bank Account Verification on the first PayOut to an account. This to avoid the risk of paying out the incorrect bank account, as executed PayOuts can not be reversed (click here for more info about the Bank Account Verification).


Other Frequently asked questions about uploading a batch


2. Transfer the funds to be distributed

Transfer the sum of your PayOuts batch to our Nedbank Payout Account (this needs to be in our bank account before the platform can release the funds, so please factor in some time for interbank clearing).


You can do this in two ways:

  • Transfer the exact amount per batch
  • Use a float to pay out from (Click here for more information)


3. Handle the Unpaids

Unpaids are the payments returned by banks for reasons such as Account Frozen / No Account exists etc.


  • If you submit via API – you will receive callback via API for unpaids
  • You can also view the unpaids in our console


We will refund the funds to you on a weekly basis (every Friday currently).

The banks say that unpaids will arrive within five working days. For payments, they are usually all in by the end of day two but there are some fringe cases where this can take longer (eg. payment made to a closed account).


Other Frequently asked questions about handling Unpaids



4. Funds reflected in the beneficiaries account

  • Batches are processed throughout the day until cut-off at 4:00 PM 
  • Your beneficiaries will see funds in their accounts from the afternoon onwards, (keep in mind inter-bank delays)


Note that we can't release payment batches when there aren't funds available.


5.  Processing over Weekends and Public Holidays

Note that there is no processing on non-business days, (weekends and Public Holidays).

* Please ensure that batches are uploaded in time for processing before weekends and Public Holidays.
* Regular processing will resume the next business working day.

A system error message will advise you to choose a different date, should the chosen date be invalid and fall on a non-processing day.