Payments
Capitec Pay
In a nutshell
Open banking payments using Capitec for South African customers — phone number, ID, or account number authorization.
Capitec Pay is an open banking payment method exclusive to South Africa. The customer authorizes payments via a push notification in their Capitec app — no card details or internet banking credentials are shared.
Info
Capitec Pay is available to businesses in South Africa only.
Copy linkCurrency
All Capitec Pay transactions must use ZAR (South African Rand).
Copy linkHow the channel works
- Your server creates a charge using the Paystack Charge API with a
qrobject andprovider: "scan-to-pay". - Paystack routes the charge to Capitec and sends a push notification to the customer's Capitec app.
- The customer opens the notification in their Capitec app and approves the payment — no need to enter card details or log into internet banking.
- Paystack confirms the outcome. Store the transaction reference to check status using the Capitec Pay Requery endpoint.
Copy linkCharge request example
curl https://api.paystack.co/charge \
-H "Authorization: Bearer YOUR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"amount": 100000,
"currency": "ZAR",
"qr": {
"provider": "scan-to-pay"
}
}' \
-X POST
Info
Store the transaction reference from the charge response. You can use it to check payment status via the Requery Transaction endpoint.
Copy linkError handling
| Error message | Code | Cause |
|---|---|---|
| Account is de-activated, please contact Capitec for help. | not_found | The customer's Capitec account is deactivated. |
| Customer details not found, please try again or contact Capitec. | not_found | The customer does not exist on Capitec's platform. |
| Capitec app not detected, please check it's installed and up to date. | not_found | The customer does not have the Capitec app installed or updated. |
| You've blocked this business, please contact Capitec for help. | charge_restricted | The customer has blocked the merchant in their Capitec app. |
| Charge Failed | amount_exceed_limit | A duplicate charge for the same amount was detected within a short time window. |
Copy linkComparison with other ZA channels
| Channel | Customer requirement | Authorization method |
|---|---|---|
| Capitec Pay | Capitec banking app | Push notification in-app |
| QR codes | Any supported banking/wallet app | Scan QR with app |
| Instant EFT | Internet banking access (any major bank) | Internet banking login |
| Card | Debit or credit card | Card details + OTP/3DS |
Was this page helpful?