South Africa
How to on-ramp and off-ramp ZAR in South Africa: bank transfer, airtime, KYC, limits and API examples.
ZA
ZAR
Live
2026-10-09
Start with Countries: it has the keys, the signing helpers, the order statuses and the retry rules that every country page uses. To take payments without the API, open the Pay Widget with countryIsoCode=ZA, see URL params.
Payment channels
Each channel has its own page with the walkthrough. Open a channel:
On-ramp means the user pays local currency and gets crypto. Off-ramp means the user pays crypto and gets local currency.
Quirks
Verify the user
Before the first order, read the user's KYC state. requiredKycType says which level the user must pass, and kycDocuments lists the documents to submit. Without the order amounts in the request it answers for the user's past orders only, so send them when you have a quote: see Get user KYC state. The rules for South Africa are in the reference.
ENDPOINT='/api/v2/user/kyc?userEmail=user%40example.com&countryIsoCode=ZA'
TIMESTAMP=$(($(date +%s) * 1000))
curl "$FONBNK_BASE_URL$ENDPOINT" \
-H "x-client-id: $FONBNK_CLIENT_ID" \
-H "x-timestamp: $TIMESTAMP" \
-H "x-signature: $(fonbnk_sign "$TIMESTAMP" "$ENDPOINT")"const response = await fonbnkRequest('GET', '/api/v2/user/kyc?userEmail=user%40example.com&countryIsoCode=ZA');Reference (production, 2026-10-09)
Limits
Per order, for a merchant on the default limits, with CELO_USDT on the crypto leg. Another asset, another carrier or your own account limits can change them: Get order limits answers for your request.
On-ramp, Bank transfer
19.06
9,523.54
1
500
Off-ramp, Bank transfer
10
7,847.19
1.02
500
Off-ramp, Airtime (za_vodacom)
16
1,000
1
64.79
KYC rules
Off-ramp KYC is on in South Africa. A rule fires when one order falls in its per-order range, or when the user's lifetime successful orders pass its allowance. When several rules fire, the higher level wins. See KYC.
On-ramp
basic
$1 to $100
over $1
—
On-ramp
advanced
$100 to any amount
—
—
Off-ramp
basic
$1 to any amount
—
—
The documents production accepts:
advanced
National IDs, Green Book, Consular IDs & Diplomat IDs
first_name, last_name, dob, images
advanced
Passports
first_name, last_name, dob, images
basic
National ID
first_name, last_name, dob, id_number
Fees
Every quote lists its fees in cashout.feeSettings and charges them in cashout.chargedFees. The amounts depend on your account, so this page names the fees and not their values. When your account sets a fee of its own, the quote also lists a merchant_fee that goes to merchant.
service_fee
platform
On-ramp, Bank transfer; Off-ramp, Bank transfer; Off-ramp, Airtime (za_vodacom)
gas
blockchain
On-ramp, Bank transfer
provider_fee
provider
Off-ramp, Bank transfer

