Sign in

Payments

Cards

View as Markdown

In a nutshell

Reference information for card payments on Paystack in South Africa.

Card payments are available in South Africa and can be used through Paystack-hosted checkout or, for PCI-compliant businesses, the Charge API.

Copy linkSupported networks

NetworkSupported markets
VisaAll Paystack markets
MastercardAll Paystack markets
American ExpressNigeria, Kenya, South Africa

Copy linkSupported card types

Paystack card authorizations can represent different issuer-issued card types, including debit, credit, and prepaid cards. In Paystack responses, the card_type field identifies the specific type returned by the issuer, such as visa credit.

Copy linkAuthentication behavior

Card authentication is dynamic and depends on issuer rules and transaction context. During a charge flow, Paystack can return statuses that require additional customer action, including:

  • send_otp when the issuer requires a one-time password
  • send_pin when the bank requires the customer's PIN
  • open_url requires the customer to authorize the transaction on a bank controlled page.
  • send_address for redirect-based confirmation on 3D Secure flows
  • pending while a charge is still being processed asynchronously

For recurring setups, Paystack supports custom filters that affect card behavior. When recurring=true is used, only Verve cards that support recurring billing are accepted, and bank authentication is forced for Mastercard and Visa.

Copy linkSecurity and compliance

Businesses sending raw card details to the Card API must satisfy PCI-DSS requirements. Paystack is a PCI Level 1 Service Provider, but direct use of the Card API is limited to businesses that can provide valid PCI compliance documentation.

Copy linkTest card data

Paystack test cards support common card-auth scenarios. Expiry can be any future date.

ScenarioPANCVVExtra input
No validation4084 0840 8408 4081408None
PIN validation5078 5078 5078 5078 12081PIN 1111
PIN + OTP5060 6666 6666 6666 666123PIN 1234, OTP 123456
Declined4084 0800 0000 5408001Declines
Insufficient funds4084 0800 0067 0037787Fails for insufficient funds

These test cards are useful for validating 2FA handling, reusable authorization behavior, and failure states without relying on live issuers.

Was this page helpful?