Overview

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.
• Make mobile money payouts in West Africa: Send funds directly to recipients' mobile wallets in seven countries using local mobile money operators.
• Verify bank accounts before executing payouts: Use bank account verification (BANV) between 03:00 and 23:00 to confirm recipient details before sending funds, reducing the risk of paying the wrong account. See supported banks for the banks that BANV supports.

Supported countries and currencies

Peach Payments supports payouts to the following countries and currencies:

Supported banks

The table below shows which South African banks Peach Payments supports for real-time EFT payouts and for bank account verification (BANV).

Supported mobile money operators

For mobile money payouts, specify the providerMethod and countryCode parameters in your create payout request. The following table shows the valid combinations:

Process overview

You can use the Payouts API to make payouts to suppliers, employees, partners, or customers. The payout method depends on the payout currency:

• Payouts in South African rand (ZAR) use real-time EFT.
• Payouts in West African CFA franc (XOF) use mobile money.

The process differs slightly depending on the payout method.

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.
  • GoTyme Bank SME account numbers that begin with 53.
• You cannot deposit funds into the Peach Payments Payouts account:
  • Using PayShap. Use RTC (recommended) or EFT instead.
  • From a GoTyme Bank Everyday account.
• Bank account verification operates between 03:00 and 23:00.
• Peach Payments holds a separate float balance for each country. Funds that you deposit for one country are not available for payouts in another country.
• You can only make mobile money payouts using the Payouts API. You cannot use the Dashboard to make single or bulk payouts.
• Each mobile money payout must be a whole amount between 200 and 5,000,000 in the payout currency. The Payouts API expects amounts in minor units, so set the amount to a multiple of 100 from 20000 to 500000000. The API accepts amounts that are not multiples of 100, but in production, the recipient receives the amount rounded up to the next whole amount. For example, if you set the amount to 20050, the recipient receives 201, not 200.50. In sandbox, those payouts fail.
• Sandbox testing might fail intermittently outside of South African office hours.

Quick links