Online banking in South Africa

To enable online banking in South Africa, you need to use direct integration. When creating a payment, send a request with the following parameters:

Parameter	Type	Required	Description
`pos_id`	UUID	✅	Merchant's identifier (`POS_ID`)
`mode`	MODE	✅	`direct`
`method`	METHOD	✅	Payment method (`purchase`)
`amount`	Number	✅	Transaction 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)
`currency`	CURRENCY	✅	ZAR
`order_3ds_bypass`	String	✅	3-D Secure flow option
`order_id`	String	✅	Unique identifier of order
`description`	String	✅	Payment description
`payway`	String	✅	banking
`server_url`	URL		Webhook notification will be sent to this URL
`result_url`	URL		Customer will be redirected to this URL after payment.
`customer_fname`	String	✅	Payer’s first name
`customer_lname`	String	✅	Payer’s last name
`customer_email`	String	✅	Payer’s e-mail address
`customer_phone`	String	✅	Payer’s phone number

Request example:

{
    "pos_id":           "00000000-0000-0000-0000-000000000000",
    "mode":             "direct",
    "amount":           1000,
    "method":           "purchase",
    "currency":         "ZAR",
    "payway":           "banking",
    "customer_fname":   "John",
    "customer_lname":   "Doe",
    "customer_phone":   "380999999999",
    "customer_email":   "[email protected]",
    "order_3ds_bypass": "supported",
    "description":      "Description",
    "order_id":         "123456789",
    "server_url":       "http://callback-stub:9000/consume",
    "result_url":       "https://google.com"
}

info

To process payouts via online banking in South Africa, please refer to the instructions.