Payouts: New product
Introduction
The Payouts API enables you to:
- Execute instant payouts at any time of the day: Unlike traditional payout methods that can take hours or days, the API processes transactions in real-time, offering immediate access to funds for recipients.
- Improve operational efficiency: By automating the payout process, the Payouts API minimises manual intervention, reducing operational overhead and the potential for errors.
- Track payouts in real-time: You can track the status of your payouts in real-time, enhancing transparency and accountability.
- Integrate seamlessly: A standardised, developer-friendly API reduces the complexity and time required for integration.
- Scale effortlessly: The API can handle high volumes of transactions, making it suitable for your growing payout needs.
See the known limitations section for details on real-time clearing (RTC) processing limits.
Peach Payments supports payouts to the following banks:
- Standard Bank
- Nedbank
- FNB
- Old Mutual Bank
- Access Bank
- African Bank
- Ubank
- Bidvest Bank
- Capitec Bank (excluding Live Better accounts)
- Absa
- HBZ Bank
- Finbond Mutual Bank
- Investec
- Finbond EPE
- Discovery Bank
- TymeBank
- Sasfin Bank
- Standard Chartered South Africa
- Albaraka Bank
Process overview
Before executing any payouts, you should send Peach Payments a source of funds document for compliance reasons.
Using the Payouts API, South African businesses can make instant EFT payments to suppliers, employees, partners, or customers.
Double-check your payout details before executing the payout.
- Once a payout is successfully submitted, you cannot recall it.
- Refunds are not supported.
- Failed payouts incur fees.
- To execute instant payouts, you must have enough funds in your Peach Payments account to cover the payout request. Deposit funds into the Peach Payments account using your unique reference.
Peach Payments processes deposits every two hours, with the processing covering the first two of the last three hours:
Deposits included from Deposits included to Processing time 00:00 02:00 03:00 02:00 04:00 05:00 04:00 06:00 07:00 06:00 08:00 09:00 08:00 10:00 11:00 10:00 12:00 13:00 12:00 14:00 15:00 14:00 16:00 17:00 16:00 18:00 19:00 18:00 20:00 21:00 20:00 22:00 23:00 22:00 00:00 01:00 If you deposit funds using:
- An RTC payment, your deposit could reflect in your account anywhere between one hour and one minute and three hours later. To ensure the shortest time between deposit and the funds reflecting in your account, deposit your funds before the times in the Deposits included to column. See the known limitations section for details on RTC processing limits.
- A normal EFT, your deposit might take up to two business days to reflect in your account, depending on cut-off times.
- Create the payout request.
- Check the reasons for any failed payouts, fix their details, and try again.
The value of any failed payouts returns to your float balance for you to use on future payouts.
Duplicate checking
Peach Payments recommends that all create payout requests include a unique payoutId
. While a unique payoutId
is not yet mandatory, it will become mandatory soon and the API will reject any duplicate requests that arrive with the same payoutId
.
Known limitations
- In South Africa, RTC operates with specific "dark hours" or processing windows that limit the value of transactions that you can process during those times:
- Business days (Monday to Friday): Day time (00h00:01 - 16h00), you can process RTC transactions with a limit of R5,000,000.
- Overnight (16h00:01 - 00h00) and during weekends or public holidays: The limit is R250,000.
- You cannot pay out to Capitec Live Better accounts.
Quick links
📝 API playground Detailed reference to the Payouts API endpoints and example calls. API reference | 🚀 Postman collection and environment Use the sample Payouts API calls in Postman. See the collection documentation for more information. Postman collection and environment. |
Updated about 11 hours ago