Payments
QR code payments
In a nutshell
QR code payments via SnapScan and Scan to Pay for businesses in South Africa.
Paystack QR code payments generate a scannable code that customers complete using a supported mobile app. No card entry or internet banking redirect is needed β the customer scans the code with an app they already use and authorizes the payment in that app.
QR code payments are available to businesses in South Africa only.
Copy linkCurrency
All QR code transactions must use ZAR (South African Rand).
Copy linkSupported providers
| Provider | Code |
|---|---|
| Scan to Pay | scan-to-pay |
Paystack QR codes work with both SnapScan and the Scan to Pay ecosystem.
Copy linkTransaction flow
- Your server creates a charge with the customer email, amount, currency (
ZAR), and aqrobject withprovider: "scan-to-pay". - Paystack returns the QR data needed for display.
- You show the QR code on screen (at checkout, on a receipt, etc.).
- The customer scans it using a supported app and approves the payment.
- Paystack sends a
charge.successwebhook event.
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": 75000,
"currency": "ZAR",
"qr": {
"provider": "scan-to-pay"
}
}' \
-X POST
Copy linkSupported consumer apps
Copy linkSnapScan
Customers can scan with the SnapScan app on iOS or Android.
Copy linkScan to Pay apps
| Banking apps | Wallets | Standalone Scan to Pay |
|---|---|---|
| Standard Bank | Ukheshe | Nedbank Scan to Pay |
| FNB Banking | Spot by Virgin Money | Standard Bank Scan to Pay |
| Nedbank Money | Vodapay | Absa Scan to Pay |
| Capitec Bank | Telkom Pay | |
| Absa | Instapay | |
| RMB | Nedbank Avo |
Copy linkReusability
QR code authorizations are not reusable. Each transaction requires a new QR charge. There is no support for recurring billing via this channel.
Copy linkWebhook confirmation
{
"event": "charge.success",
"data": {
"status": "success",
"reference": "your_reference",
"amount": 75000,
"currency": "ZAR",
"channel": "qr"
}
}
Always wait for the charge.success webhook before fulfilling orders.