Sign in

Payments

Capitec Pay

View as Markdown

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

  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.

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 messageCodeCause
Account is de-activated, please contact Capitec for help.not_foundThe customer's Capitec account is deactivated.
Customer details not found, please try again or contact Capitec.not_foundThe customer does not exist on Capitec's platform.
Capitec app not detected, please check it's installed and up to date.not_foundThe customer does not have the Capitec app installed or updated.
You've blocked this business, please contact Capitec for help.charge_restrictedThe customer has blocked the merchant in their Capitec app.
Charge Failedamount_exceed_limitA duplicate charge for the same amount was detected within a short time window.

Copy linkComparison with other ZA channels

ChannelCustomer requirementAuthorization method
Capitec PayCapitec banking appPush notification in-app
QR codesAny supported banking/wallet appScan QR with app
Instant EFTInternet banking access (any major bank)Internet banking login
CardDebit or credit cardCard details + OTP/3DS
Was this page helpful?