Paystack with PrestaShop

PrestaShop has a smaller footprint in anglophone Africa (Nigeria, Kenya, Ghana) than WooCommerce or Shopify, but it has a loyal user base, particularly in francophone West Africa. Merchants in Senegal, Cote d'Ivoire, Cameroon, and the Democratic Republic of Congo often choose PrestaShop because it has strong French language support, an active French-speaking community, and official documentation in French.

The platform sits between WooCommerce's flexibility and Shopify's managed simplicity. It is self-hosted (you manage your own server), but it does not require WordPress. It handles product catalogs, orders, shipping, and customer management out of the box. The module system lets you extend functionality with payment gateways, shipping integrations, and marketing tools.

For African merchants, the key advantage of PrestaShop is its multi-language and multi-currency support. A store in Cameroon can serve customers in French and English, display prices in XAF and XOF, and process payments through Paystack's supported channels. That flexibility matters in Africa's linguistically diverse markets.

This guide is part of the Paystack plugins and no-code integrations cluster.

The Paystack PrestaShop module is available on GitHub. Installation is manual.

Step 1: Download the module. Clone or download the Paystack PrestaShop module from GitHub. The module should include a directory structure that matches PrestaShop's modules format.

Step 2: Upload to your server. Upload the module directory (typically named paystack) to the modules directory of your PrestaShop installation using FTP, SFTP, or your hosting file manager.

Step 3: Install through the admin panel. Log in to your PrestaShop admin (Back Office). Navigate to Modules > Module Manager (or Modules > Modules & Services in older versions). Search for "Paystack" in the module list. Click "Install."

Step 4: Configure. After installation, click "Configure" on the Paystack module. Enter your API keys from the Paystack Dashboard. Set the module to test mode. Save the configuration.

Step 5: Set the webhook URL. The configuration page should display the webhook URL. Copy it and paste it into the Paystack Dashboard under Settings > API Keys & Webhooks.

The Paystack module configuration in PrestaShop typically includes:

API Keys. Test and live public and secret keys. Always start with test keys.

Payment Mode. Toggle between test and live environments.

Payment Title. The text that appears at checkout. You can customize this per language if your store supports multiple languages. For a French-English store, you might set "Payer avec Paystack" for French and "Pay with Paystack" for English.

Order Status Mapping. Map Paystack payment outcomes to PrestaShop order statuses. Typically: successful payment maps to "Payment accepted," failed payment maps to "Payment error," and pending payment maps to "Awaiting payment."

Checkout Style. Some versions of the module support choosing between the inline popup and the redirect flow. The inline popup keeps the customer on your site. The redirect sends them to Paystack's hosted payment page.

Logo Display. You can configure whether the Paystack logo or payment method icons (Visa, Mastercard, M-Pesa) appear at checkout.

PrestaShop's module system uses hooks to integrate with the checkout flow. The Paystack module registers on the payment hook, which means it appears as a payment option at the payment step of checkout. You do not need to modify any PrestaShop templates manually.

PrestaShop's native multi-language support is one of its strongest features for African merchants. Here is how it interacts with Paystack:

Language. The Paystack module's checkout text (payment method title, description, error messages) can be translated through PrestaShop's translation system. Go to International > Translations, select the module translations category, and translate the Paystack module's strings into your store's languages.

Currency. PrestaShop supports multiple currencies with automatic or manual exchange rates. However, Paystack processes payments in the currency of your Paystack account. If your store displays prices in USD but your Paystack account is in NGN, the module needs to convert the amount to NGN before sending it to Paystack. Check whether the module handles this conversion automatically or if you need to configure your store's default currency to match your Paystack account.

The safest approach: set your store's primary currency to match your Paystack account's currency. Display other currencies for convenience, but process payments in the Paystack-compatible currency. This avoids conversion errors and ensures the amount your customer sees matches the amount Paystack charges.

Test the complete checkout flow before going live:

1. Enable test mode in the Paystack module configuration.
2. Browse your store. Add a product to the cart.
3. Go to checkout. Fill in the customer information and shipping details.
4. On the payment step, select Paystack.
5. Complete payment with Paystack's test card (4084 0840 8408 4081, any future expiry, CVV 408).
6. Verify the order confirmation page appears.
7. Check the order in your PrestaShop admin (Orders > Orders). It should have the correct status.
8. Check the Paystack Dashboard for the test transaction.
9. Check the Paystack webhook logs for a successful delivery.

Test edge cases too: what happens if the customer closes the payment popup? What happens if they click "Back" during payment? These scenarios should leave the order in a "Pending" or "Awaiting payment" state, not in "Payment accepted."

Once testing passes, switch to live API keys, save the configuration, and test with a small real transaction.

Module not appearing at checkout. Check that the module is both installed and enabled. In PrestaShop, installing a module does not automatically enable it for all customer groups or zones. Go to the module configuration and verify it is enabled. Also check Module Manager > Modules to ensure there are no error messages.

Payment page shows a blank section. Clear the PrestaShop cache (Advanced Parameters > Performance > Clear Cache). A stale cache can prevent new modules from rendering correctly. Also check the browser console for JavaScript errors.

Order status not updating after payment. The webhook is the most likely cause. Verify the webhook URL in the Paystack Dashboard. Check the webhook delivery logs. Common blockers: the URL is wrong, the server returns a non-200 response, or a security module on your server blocks POST requests from external sources.

Currency conversion issues. If the amount charged on Paystack does not match the price displayed on your store, there is a currency mismatch. Either your store is displaying prices in a different currency than your Paystack account supports, or the conversion is incorrect. Set your primary currency to match your Paystack account and verify the amounts.

Compatibility with PrestaShop 8.x. PrestaShop 8 introduced significant changes to the module system and Symfony framework integration. Some older Paystack modules may not be compatible. Check the GitHub repository for PrestaShop 8 compatibility or look for a community fork that supports the latest version.