PrestaShop Payment Gateway: How to Choose and Integrate a Provider

PrestaShop is a widely deployed open-source e-commerce platform with a large European merchant base. Its modular architecture and active developer community make it well-suited to integrating a wide range of payment gateways, from simple hosted checkout redirects to full REST API integrations with native checkout experience. The right payment gateway for a PrestaShop store depends on the merchant's category, target markets, supported payment methods, and how much technical resource is available for integration and maintenance. This guide covers how to evaluate options, integration methods, and how to connect RoxPay to a PrestaShop store.

PrestaShop Payment Gateway | RoxPay

Payment Gateway Options for PrestaShop Stores

PrestaShop's payment ecosystem includes several tiers of gateway options, each with different integration depth and commercial positioning.

PrestaShop Marketplace modules: The official PrestaShop Marketplace contains modules from major gateway providers. These are built to the platform's module specification, install via the PrestaShop admin interface, and are regularly updated for compatibility with current PrestaShop versions. The quality and maintenance of these modules varies significantly by provider.

Third-party modules from the developer community: Many payment gateways have community-built modules available through PrestaShop Addons or GitHub. These modules are sometimes of high quality but may not be actively maintained. Module compatibility with your specific PrestaShop version should be confirmed before installation.

REST API integration: For gateways whose modules are not available, not maintained, or not suitable for the merchant's specific requirements, a direct REST API integration allows full control over the checkout experience. This requires development work but is not significantly more complex than module installation for a developer familiar with PrestaShop's payment module architecture.

Hosted page redirect: The simplest integration approach, requiring minimal PrestaShop development. The gateway provides a URL to which PrestaShop redirects customers at checkout. Customers enter payment details on the gateway's hosted page and are returned to PrestaShop's confirmation page. This approach minimises PCI scope and development time at the cost of some checkout experience quality.

For PrestaShop merchants in high-risk categories, the module marketplace is a limited resource because most gateway modules connect to standard acquirers that decline high-risk businesses. Merchants in gambling, adult content, forex, CBD, or other restricted categories need a high risk payment gateway with a direct REST API or a custom module, rather than relying on finding a suitable module in the standard marketplace.

Evaluation Criteria: Module Quality, Fees, PCI Compliance

Choosing the right payment gateway for PrestaShop requires evaluating several dimensions that affect both the technical implementation and the commercial outcome.

Module quality and maintenance: A payment module that breaks with a PrestaShop update can stop your store from processing payments. Before committing to a gateway based on its module, review the module's update history. Is it updated regularly? Are there recent reviews from merchants running your PrestaShop version? Is the module provider's support team responsive to module-specific issues? A module that has not been updated in 12 months for a platform with frequent releases is a risk.

Fee structure: Request the full fee schedule, not just the headline processing rate. The difference between blended pricing (a flat percentage that hides interchange and scheme fees) and IC++ pricing (where you see each cost component separately) can be significant on real transaction volumes. RoxPay uses IC++ from 0.45% markup, meaning every invoice shows the breakdown between interchange, scheme fees, and gateway markup.

PCI DSS compliance: Confirm the gateway is PCI DSS Level 1 certified and that the integration method you choose minimises your PCI scope. A hosted page or drop-in UI (iFrame-based) integration eliminates most PCI obligations from your PrestaShop server. A gateway that requires your server to handle raw card data introduces significant PCI compliance requirements.

3D Secure 2 support: Required for EU merchants under PSD2 Strong Customer Authentication. Confirm the gateway and its PrestaShop module support 3DS2 natively. A module that implements 3DS1 only creates compliance risk and conversion problems as issuers apply SCA requirements that the older protocol cannot satisfy efficiently.

Supported payment methods: For European PrestaShop stores, verify the gateway supports Visa, Mastercard, American Express, Apple Pay, Google Pay, and any local payment methods relevant to your target market. Settlement currency and available currencies are also important for stores serving international customers.

Integration Methods for PrestaShop: Module vs API

The integration method affects development time, PCI scope, checkout experience, and long-term maintenance requirements.

Module installation (standard): Installing a PrestaShop payment module follows a standard process: download the module package, install via the Module Manager in the PrestaShop admin, enter your gateway API credentials in the module's configuration, and configure the payment methods to display at checkout. For modules that implement a hosted page or drop-in UI, PCI scope is minimal. Testing the module in PrestaShop's sandbox mode before going live is essential.

Custom module development (API-based): Building a custom PrestaShop payment module that calls a gateway's REST API directly is the approach for gateways without pre-built modules or for merchants with specific checkout requirements. PrestaShop's payment module architecture is well-documented and a developer familiar with PrestaShop module development can implement the integration in a few days. The module structure handles the payment initiation, return URL management, and order status updates; the REST API handles the payment processing itself.

Webhook handling in PrestaShop: For reliable order management, configure your PrestaShop integration to listen for webhook events from the gateway rather than relying solely on redirect confirmation. A customer whose browser closes after payment but before the redirect completes will have a paid transaction with no order confirmation unless your integration handles the webhook as the authoritative payment confirmation. The RoxPay REST API delivers webhooks for all payment events with retry logic for temporary failures. Full documentation is available at app.roxpay.eu/api/v4/docs.

Testing before go-live: PrestaShop supports a sandbox mode that allows you to place test orders. Combine this with the gateway's sandbox environment to test the full payment flow, including 3DS2 challenges, decline scenarios, and refund processing, before switching to production credentials.

High Risk Merchants on PrestaShop

PrestaShop is a technically capable platform for high-risk merchants, but the payment gateway layer requires specific attention. Most standard gateway modules in the PrestaShop ecosystem connect to acquirers that decline high-risk categories on underwriting review.

The practical problem: A merchant running an adult content store, online pharmacy, CBD shop, or supplement business on PrestaShop installs what appears to be a capable payment module, applies for the merchant account, and receives an approval that is later reversed when the acquirer's risk team reviews the actual business type. This wastes time and creates a period of payment processing disruption.

What high-risk PrestaShop merchants need: A gateway that explicitly accepts their merchant category, has genuine acquiring relationships for that category (not just marketing claims), and provides a PrestaShop-compatible integration method. For merchants in this position, a direct REST API integration with a specialist high-risk processor is more reliable than seeking a pre-built module.

Documentation requirements: High-risk PrestaShop merchants should prepare their full documentation package before applying. This includes business registration, director identity verification, operating licences where applicable, recent bank statements, and processing history from any previous payment providers. A complete, well-prepared application accelerates underwriting and reduces the probability of approval delays.

Compliance on the PrestaShop storefront: The merchant's PrestaShop store must display appropriate legal information: terms and conditions, privacy policy, refund policy, and, for age-restricted products, age verification mechanisms. Acquirers review the merchant's website as part of underwriting and a compliant, professional storefront supports a faster and more positive review.

Connecting RoxPay to Your PrestaShop Store

RoxPay integrates with PrestaShop via its REST API, allowing merchants to add RoxPay payment processing to their PrestaShop checkout. The integration supports the full range of RoxPay payment methods and works with both standard and high-risk merchant categories.

Integration approach: RoxPay provides REST API documentation with a PrestaShop-relevant integration guide. A PrestaShop developer can build a custom payment module using the API documentation as the basis, following the standard PrestaShop module architecture for payment controllers. Alternatively, a hosted page integration (redirect to RoxPay's checkout page and return) can be implemented with minimal PrestaShop development.

Supported payment methods on PrestaShop: Through the RoxPay integration, PrestaShop stores can accept Visa, Mastercard, American Express, Apple Pay, Google Pay, PayPal, and over 40 additional payment circuits. The payment methods displayed at checkout are configured in the RoxPay merchant dashboard.

Onboarding process: To start your RoxPay application for a PrestaShop integration, complete the online onboarding form indicating your e-commerce platform and merchant category. Standard merchant categories are approved within 24-48 hours of complete documentation. High-risk categories undergo additional underwriting review. Sandbox credentials are available immediately upon registration for development work to proceed in parallel.

Pricing: IC++ pricing from 0.45% markup, settlement to any SEPA bank in 24-48 hours, 99.9% uptime SLA. RoxPay is PCI DSS Level 1 certified (certificate QS83A47X629) and ISO 27001 certified, providing the security infrastructure that PrestaShop merchants rely on to meet their own PCI compliance obligations through the gateway.


Frequently Asked Questions

Does RoxPay have an official PrestaShop module?

RoxPay integrates with PrestaShop via its REST API. Merchants can build a custom PrestaShop payment module using the REST API documentation and PrestaShop's standard payment module architecture. The RoxPay technical team provides integration guidance for PrestaShop specifically, and the process for a developer familiar with PrestaShop modules typically takes two to three days.

Can I accept PayPal through a PrestaShop RoxPay integration?

Yes. RoxPay supports PayPal as a payment method alongside cards and digital wallets. PayPal can be presented as a checkout option within the same RoxPay integration rather than requiring a separate PayPal module and merchant account on your PrestaShop store.

What PrestaShop version is compatible with a RoxPay integration?

RoxPay's REST API is platform-agnostic; it does not have PrestaShop-version-specific requirements. A custom module built to RoxPay's API specification can be developed for any supported PrestaShop version. The module developer should follow current PrestaShop module development standards for the target version to ensure compatibility with the platform's payment controller architecture.

Get started today

Optimize your payments today

RoxPay integrates with PrestaShop via REST API with IC++ pricing from 0.45%, high-risk category acceptance, and settlement to any SEPA bank in 24-48 hours. PCI DSS Level 1 certified.

✓ No monthly fixed costs · ✓ Activation in 24 hours · ✓ Dedicated technical support