Skip to main content
POST
ZAR Collection Application

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer
required

Business ID (obtained from backend, needs to pass the corresponding Business ID based on the currency in the URL)

orderId
string
required

Merchant order number

Maximum string length: 48
name
string
required

Payer name

phone
string
required

Payer mobile number

email
string<email>
required

Payer email address

amount
string
required

Transaction amount (unit: ZAR), up to 2 decimal places. Range: 1-10,000,000

payType
enum<string>
required

Payment Method Type: BANK_TRANSFER

Available options:
BANK_TRANSFER
inBankCode
string
required

Payment Method Code: 051001 / 198765 / 250655 / 430000 / 462005 / 580105 / 632005 / 678910

callBackUrl
string<uri>
required

Redirect URL after successful payment

callBackFailUrl
string<uri>
required

Redirect URL after failed payment

subject
string
required

Payment remark (transaction title, product name, payment reason)

partnerUserId
string
required

Unique user identifier (e.g., userId), used for risk control system, must be valid, otherwise it will affect the transaction. Format: digits, letters, or symbols -~!@#$%&*()_

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
required

Signature

notifyUrl
string<uri>

Callback URL

body
string

Remark details

Response

200 - application/json
status
string

1: Normal, 0: Exception

error
string

Error code

msg
string

Error description

data
object
Last modified on August 12, 2026