PayoutsMarkets

South Africa Payouts

ZAR payouts to bank accounts

Use this guide when you want to send ZAR payouts to recipients in South Africa. South Africa supports bank transfers only.

Overview

  • Currency: ZAR
  • Payment location: ZAF
  • Supported rails: Bank transfer
  • Payment method: paymentMethodId: "banktransfer", recipient.type: "bank_account"

Required fields (bank transfer)

FieldRequiredNotes
accountNumberYesBank account number
bankCodeYesLocal bank code
accountHolderNameYesName on the account
countryYesZAF
phoneNumberNoInternational format

Top-level required fields for every payout: merchantId, merchantReference, destinationValue (with minorAmount and currency), paymentMethodId, paymentLocation, recipient.

Example request

1{
2  "merchantId": "your-merchant-id",
3  "merchantReference": "PAYOUT-ZA-001",
4  "destinationValue": {
5    "minorAmount": 250000,
6    "currency": "ZAR"
7  },
8  "paymentMethodId": "banktransfer",
9  "paymentLocation": "ZAF",
10  "recipient": {
11    "type": "bank_account",
12    "accountNumber": "0123456789",
13    "bankCode": "001",
14    "accountHolderName": "Sipho Dlamini",
15    "country": "ZAF"
16  }
17}