SWIFT Payouts

Supported Currencies

ZAR, AUD, USD, EUR

Field Requirements

Object	Parameter	Requirements
Payment Address	accountReference	Required
	routingCode	Sort Code or SWIFT BIC is required for ZAR payments. SWIFT BIC is required for payouts in AUD, USD or EUR Sort Code: 6-digit sort code RegEx format: ^\d{6}$ SWIFT BIC (8) or (11): xxxxZAxx or xxxxZAxxxxx RegEx format: ^[A-Z]{4}ZA[A-Z0-9]{2}([A-Z0-9]{3})?$
	bankCountry	ZA
	accountName	Only required if the name on the account differs to the Recipient name
Recipient	physicalAddress	Country, City, streetName and Postal Code are required
	corporateName	Required if recipientType = “corporate”
	firstName & lastName	First Name and Last Name if recipientType = “Individual”
Payout	paymentReason	Select Payment Reason Code from list below
	reference	For payouts in ZAR that relate to Tax, please include 19 digit PRN number in the 'reference' field. Example: /PRN/xxxxxxxxxxxxxxxxxxx.

Payment Reason Codes

PaymentReason Code	Description
buying_a_vehicle	Payment related to the purchase of a vehicle, such as a car or motorcycle.
buying_or_selling_a_business	Transactions involved in the acquisition or sale of a business entity.
buying_or_selling_shares	Payments related to the buying or selling of stocks or shares in financial markets.
donating_to_charity	Contributions made to a charitable organization for philanthropic purposes.
emigration	Payments associated with the process of permanently moving to another country.
family_support	Financial assistance provided to family members for their well-being or specific needs.
gift	Monetary transfers given as a present or token of goodwill.
inheritance	Funds received as part of an inheritance from a deceased person's estate.
living_expenses	Payments for day-to-day living costs, such as rent, utilities, and groceries.
medical_costs	Transactions covering medical expenses, including healthcare services and medications.
online_store_purchase	Payments made for goods or services purchased through online stores or e-commerce platforms.
paying_bills_or_mortgage	Settlements for regular bills or mortgage payments.
paying_business_invoice	Clearing invoices or bills related to business transactions.
paying_for_holiday_or_accomodation	Expenses for vacations, travel, or accommodation.
payroll	Salary disbursements for employees of a company or organization.
pension_or_superannuation_transfer	Transfers of funds related to pension or superannuation accounts.
professional_services	Payments for services provided by professionals, such as consultants or freelancers.
property_purchase_or_sale	Transactions involving the acquisition or sale of real estate.
repatriating_overseas_earnings	Repatriating Overseas Earnings
salary_transfer	Transfers of salary or wages between accounts.
tax	Financial transactions associated with taxes
tuition_or_school_fees	Payments for educational expenses, including tuition and school fees.
wedding	Financial transactions associated with wedding expenses and preparations.
other	Miscellaneous category for payments not covered by the specified reasons.