# QR code payments

> 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.

## Currency

All QR code transactions must use **ZAR** (South African Rand).

## Supported providers

<table>
<thead>
  <tr>
    <th>
      Provider
    </th>
    
    <th>
      Code
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Scan to Pay
    </td>
    
    <td>
      <code>
        scan-to-pay
      </code>
    </td>
  </tr>
</tbody>
</table>

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

## Transaction 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.

## Charge request example

```bash
curl https://api.paystack.co/charge \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "amount": 75000,
    "currency": "ZAR",
    "qr": {
      "provider": "scan-to-pay"
    }
  }' \
  -X POST
```

## Supported consumer apps

### SnapScan

Customers can scan with the SnapScan app on iOS or Android.

### Scan to Pay apps

<table>
<thead>
  <tr>
    <th>
      Banking apps
    </th>
    
    <th>
      Wallets
    </th>
    
    <th>
      Standalone Scan to Pay
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Standard Bank
    </td>
    
    <td>
      Ukheshe
    </td>
    
    <td>
      Nedbank Scan to Pay
    </td>
  </tr>
  
  <tr>
    <td>
      FNB Banking
    </td>
    
    <td>
      Spot by Virgin Money
    </td>
    
    <td>
      Standard Bank Scan to Pay
    </td>
  </tr>
  
  <tr>
    <td>
      Nedbank Money
    </td>
    
    <td>
      Vodapay
    </td>
    
    <td>
      Absa Scan to Pay
    </td>
  </tr>
  
  <tr>
    <td>
      Capitec Bank
    </td>
    
    <td>
      Telkom Pay
    </td>
    
    <td>
      
    </td>
  </tr>
  
  <tr>
    <td>
      Absa
    </td>
    
    <td>
      Instapay
    </td>
    
    <td>
      
    </td>
  </tr>
  
  <tr>
    <td>
      RMB
    </td>
    
    <td>
      Nedbank Avo
    </td>
    
    <td>
      
    </td>
  </tr>
</tbody>
</table>

## Reusability

QR code authorizations are **not reusable**. Each transaction requires a new QR charge. There is no support for recurring billing via this channel.

## Webhook confirmation

```json
{
  "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.
