Skip to main content

Payouts via online banking in South Africa

To make account credits using online banking in South Africa, a request to the Tranzzo API must contain the following parameters:

ParameterTypeRequiredDescription
pos_idUUIDMerchant's identifier (POS_ID)
modeMODEdirect
methodMETHODPayment method (credit)
amountNumberTransaction amount. Must be a positive number. The number of decimal digits must be less than or equal to 2 (e.g., 100.00, 250, 50.50)
currencyCURRENCYZAR
order_3ds_bypassString3-D Secure flow option
order_idStringUnique identifier of order
descriptionStringPayment description
paywayStringbanking
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
customer_fnameStringPayer’s first name
customer_lnameStringPayer’s last name
recipient_phoneStringPayer’s phone number.
customer_emailStringPayer’s email address
properties.instrument_typeStringInstrument type
properties.account_numberStringRecipient’s bank account number (provided by client)
properties.bank_accountStringRecipient’s bank ID (provided by client)

Request example:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 400,
"method": "credit",
"currency": "ZAR",
"payway": "banking",
"customer_email": "[email protected]",
"customer_phone": "01012345678",
"customer_fname": "John",
"customer_lname": "Dou",
"Properties":{
"instrument_type": "bank_transfer",
"account_number": "9026633",
"bank_account": "0001"
},
"order_3ds_bypass": "supported",
"description": "Description",
"order_id": "123456789",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}