Peach Payments

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 [email protected]. 

1. Upload a PayOuts batch

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

• for the API documentation and Process overview  here
• for the CSV file upload – you can upload a batch file to peachpay.co.za for the PayOuts. You can find a sample . CSV here

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

• How to prevent duplicate batches being submitted?
• What are the acceptable Account Type values?

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

• Is there a retry mechanism for Unpaids callbacks?
• Whitelisting IP address for PayOuts callback notifications
• How can we test unpaid notifications on our callback URL?

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.