Docs
This feature is a Private Beta Release. Contact Chargebee support to enable Paystack for your Test and Live site.
Paystack is a leading online payment processing platform that enables businesses to accept payments seamlessly. With an easy-to-integrate API and support for multiple currencies, Paystack helps businesses grow by providing secure, efficient, and user-friendly payment solutions. It is particularly popular in Africa, offering a localized payment experience that caters to the unique needs of the region.
You can integrate Paystack with Chargebee using the following:
| Integration Method | Description | PCI Requirements |
|---|---|---|
| Chargebee Hosted Pages | In this method, customers' card information is collected by Chargebee's checkout and directly passed on to Paystack. | Low (Your PCI compliance is significantly reduced by using Chargebee's Checkout) |
| Chargebee JS | In this method, you can use Chargebee Components and Hosted Fields to collect the customer's card details. | Low |
| Chargebee JS | Via Raw Card details You will collect raw card details via your custom checkout and pass them to Chargebee.js. |
High |
| Chargebee API | In this method, you will collect card information and pass it on to Chargebee. Chargebee then routes this card information to Paystack. Since you will be collecting card information directly, you will have to take care of PCI Compliance requirements. | High |
| Chargebee API using Tokens | Using Permanent Token, a token that represents a customer's card details stored in the Paystack vault to process payments. | When using a direct gateway token, PCI requirements are minimal to None. |
Consider the following factors before choosing Paystack as a payment solution:
The United States Dollar (USD) is accepted only in Kenya and Nigeria.
Chargebee currently supports only Card payments made via Paystack.
With Paystack, you can receive payments from customers anywhere in the world using a Mastercard, Visa, or Verve card. For Nigeria, Kenya, and South Africa-based businesses, Paystack also supports international payments through American Express cards.
Learn how to enable international payments for your business using Paystack.
| Cards | Supported Countries |
|---|---|
| Mastercard | Global (Accepted worldwide) |
| Visa | Global (Accepted worldwide) |
| Verve | Global (Accepted worldwide) |
| American Express | Nigeria, Kenya, and South Africa (for international payments) |
The following limitations apply to the Paystack gateway integration with Chargebee:
Chargebee requires your Paystack Secret Key for connecting with the gateway, and for subsequent API interaction with Paystack.
Follow the steps below to fetch the information that you will be required to enter in your Chargebee site:
Login to your Paystack Account .
Go to Settings from the left navigation menu and select the API Keys & Webhooks tab.
Scroll down to the API Configuration - Test Mode section. Copy the Test Secret Key and save it for later use.
Scroll to the API Configuration - Live Mode section. Copy the Live Secret Key and save it for use in the configuration in Chargebee.
Follow the steps below to configure Paystack in your Chargebee site:
Login to your Chargebee site .
Go to Settings > Configure Chargebee > Payment Gateways.
Click Add Gateway and select Paystack.
Enter the Secret Key as copied from your Paystack account in Step 3 of the previous section.
Click Connect.
When connecting your Paystack gateway account, use a clear naming convention to easily identify each account. Since Paystack requires a separate gateway account for each currency, we recommend naming them based on the country and currency.
Follow the steps below to configure card settings for your Paystack account in Chargebee:
The Cards payment method is enabled by default. On the Configure Paystack page, click Manage to enable other settings.
Enable the following:
Click Save.
Since 3D Secure (3DS) is mandatory for Paystack, adding a payment method using raw card details via API may fail. This is especially relevant for Merchant-Initiated Transactions (MITs), which might require prior authentication via 3DS before being used for subsequent payments.
Follow these additional steps to complete the configuration of the Paystack gateway in Chargebee:
Go to Settings > Configure Chargebee > Currencies. Review your Currency settings and add the required currency.
Review your Smart Routing settings to update gateway preferences to payment methods.
Configure mandatory Email Field. Follow these steps:
a. Go to Settings > Configure Chargebee > Checkout & Self-Serve Portal.
b. Select the Fields tab and enable Email under Account Information. Email must be set as a mandatory field for creating customers and charges at Paystack.
This integration supports the use of the Payment Initiator API parameter, which, when passed along with the transaction, helps Chargebee distinguish between Customer-Initiated and Merchant-Initiated transactions and handle the payment more effectively.
Articles & FAQ