Sign in

Payments

QR code payments

View as Markdown

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

ProviderCode
Scan to Payscan-to-pay

Paystack QR codes work with both SnapScan and the Scan to Pay ecosystem.

Copy linkTransaction flow

  1. Your server creates a charge with the customer email, amount, currency (ZAR), and a qr object with provider: "scan-to-pay".
  2. Paystack returns the QR data needed for display.
  3. You show the QR code on screen (at checkout, on a receipt, etc.).
  4. The customer scans it using a supported app and approves the payment.
  5. Paystack sends a charge.success webhook 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 appsWalletsStandalone Scan to Pay
Standard BankUkhesheNedbank Scan to Pay
FNB BankingSpot by Virgin MoneyStandard Bank Scan to Pay
Nedbank MoneyVodapayAbsa Scan to Pay
Capitec BankTelkom Pay
AbsaInstapay
RMBNedbank 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.

Was this page helpful?