# Capitec Pay

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

<callout type="info">

Capitec Pay is available to businesses in South Africa only.

</callout>

## Currency

All Capitec Pay transactions must use **ZAR** (South African Rand).

## How the channel works

1. Your server creates a charge using the Paystack Charge API with a `qr` object and `provider: "scan-to-pay"`.
2. Paystack routes the charge to Capitec and sends a push notification to the customer's Capitec app.
3. The customer opens the notification in their Capitec app and approves the payment — no need to enter card details or log into internet banking.
4. Paystack confirms the outcome. Store the transaction reference to check status using the Capitec Pay Requery endpoint.

## 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": 100000,
    "currency": "ZAR",
    "qr": {
      "provider": "scan-to-pay"
    }
  }' \
  -X POST
```

<callout type="info">

Store the transaction `reference` from the charge response. You can use it to check payment status via the Requery Transaction endpoint.

</callout>

## Error handling

<table>
<thead>
  <tr>
    <th>
      Error message
    </th>
    
    <th>
      Code
    </th>
    
    <th>
      Cause
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Account is de-activated, please contact Capitec for help.
    </td>
    
    <td>
      <code>
        not_found
      </code>
    </td>
    
    <td>
      The customer's Capitec account is deactivated.
    </td>
  </tr>
  
  <tr>
    <td>
      Customer details not found, please try again or contact Capitec.
    </td>
    
    <td>
      <code>
        not_found
      </code>
    </td>
    
    <td>
      The customer does not exist on Capitec's platform.
    </td>
  </tr>
  
  <tr>
    <td>
      Capitec app not detected, please check it's installed and up to date.
    </td>
    
    <td>
      <code>
        not_found
      </code>
    </td>
    
    <td>
      The customer does not have the Capitec app installed or updated.
    </td>
  </tr>
  
  <tr>
    <td>
      You've blocked this business, please contact Capitec for help.
    </td>
    
    <td>
      <code>
        charge_restricted
      </code>
    </td>
    
    <td>
      The customer has blocked the merchant in their Capitec app.
    </td>
  </tr>
  
  <tr>
    <td>
      Charge Failed
    </td>
    
    <td>
      <code>
        amount_exceed_limit
      </code>
    </td>
    
    <td>
      A duplicate charge for the same amount was detected within a short time window.
    </td>
  </tr>
</tbody>
</table>

## Comparison with other ZA channels

<table>
<thead>
  <tr>
    <th>
      Channel
    </th>
    
    <th>
      Customer requirement
    </th>
    
    <th>
      Authorization method
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Capitec Pay
    </td>
    
    <td>
      Capitec banking app
    </td>
    
    <td>
      Push notification in-app
    </td>
  </tr>
  
  <tr>
    <td>
      QR codes
    </td>
    
    <td>
      Any supported banking/wallet app
    </td>
    
    <td>
      Scan QR with app
    </td>
  </tr>
  
  <tr>
    <td>
      Instant EFT
    </td>
    
    <td>
      Internet banking access (any major bank)
    </td>
    
    <td>
      Internet banking login
    </td>
  </tr>
  
  <tr>
    <td>
      Card
    </td>
    
    <td>
      Debit or credit card
    </td>
    
    <td>
      Card details + OTP/3DS
    </td>
  </tr>
</tbody>
</table>
