Setting up payment methods is one of the most important steps when launching an online store. PrestaShop allows merchants to integrate payment solutions so customers can pay securely and conveniently during checkout. By configuring the right payment methods, you can improve the shopping experience, reduce abandoned carts, and make order processing easier.
In this guide, you will learn how to configure payments in PrestaShop, install payment modules, connect a payment provider, enable payment methods, and troubleshoot common payment issues.
What Are Payment Methods in PrestaShop?
Payment methods allow customers to pay for products purchased from your online store. PrestaShop supports payment integrations through modules, with available options depending on your store version, location, currency, and payment provider.
Common payment options include:
- Credit and debit cards
- UPI payments
- Digital wallets
- Bank transfers
- Cash on delivery (COD)
- Payment gateways such as PayPal and Stripe, where supported
For Indian eCommerce stores, merchants may also consider payment providers such as Razorpay, Cashfree Payments, or PayU, subject to their eligibility and available PrestaShop integrations.
Step 1: Log In to Your PrestaShop Back Office
Start by logging in to your PrestaShop administration panel.
Open the Modules section and select the module management page. Depending on your PrestaShop version, this may be labeled Module Manager.
From here, you can search for payment modules, install new integrations, and manage existing modules.
Step 2: Choose a Suitable Payment Gateway
Before installing a payment module, choose a provider that supports your business requirements.
Consider the following factors:
- Supported countries and currencies
- Available payment methods
- Transaction fees and settlement times
- Refund and chargeback management
- Security and compliance requirements
- Compatibility with your PrestaShop version
- Availability of technical support
For example, an Indian store selling primarily to domestic customers may prioritize UPI, cards, and net banking. An international store may need card payments and digital wallets supported in its target markets.
Always check the provider’s official documentation for the latest compatibility and eligibility requirements.
Step 3: Install the Payment Module
Once you have selected a payment provider, install its official or trusted PrestaShop module.
Follow these steps:
- Open the Module Manager in your PrestaShop Back Office.
- Search for the payment provider’s official module.
- Review the module’s compatibility and documentation.
- Install the module.
- Enable it if required.
- Open the module’s configuration settings.
If the module is not available in the built-in catalog, download it from the payment provider or a trusted source. Upload it through the appropriate module installation interface for your PrestaShop version.
Only install modules from trusted sources, as payment modules handle sensitive checkout information.
Step 4: Connect Your Payment Gateway Account
Most online payment gateways require a merchant account before you can accept payments.
Create an account with your selected provider and complete its business verification process.
The provider may supply credentials such as:
- API key
- API secret or secret key
- Merchant ID
- Client ID or other account identifiers
Open your payment module’s configuration page and enter the credentials requested by the provider.
Important: Use test or sandbox credentials while testing your setup. Never publish secret keys, share them with unauthorized people, or place them in publicly accessible code.
The exact configuration fields depend on the payment provider and module.
Step 5: Configure Payment Methods
After connecting your account, select the payment methods you want to offer customers.
Depending on the provider, available methods may include:
Credit and debit cards: Allow customers to pay using supported cards.
UPI: Enable UPI payments if your provider and module support them.
Digital wallets: Offer supported wallets for eligible customers.
Bank transfers: Allow customers to transfer funds directly to your business account.
Cash on delivery: Let customers pay when their order arrives, if COD is suitable for your business.
You may need to configure each method separately. Review transaction fees, settlement conditions, and availability before enabling it.
Step 6: Configure Currency and Country Settings
Payment availability often depends on the customer’s country and the currency used at checkout.
In your PrestaShop Back Office, review the relevant international settings for countries, currencies, and localization.
Make sure that:
- Your store’s currency is supported by the payment provider.
- The customer’s billing country is eligible.
- Shipping destinations match your business requirements.
- Tax and total calculations are correct.
- The provider supports the intended payment method in the selected market.
If you sell internationally, test the checkout flow for the countries and currencies you plan to support.
Step 7: Enable Secure Checkout
Security is essential when accepting online payments.
Follow these best practices:
- Enable HTTPS across your entire website using a valid SSL/TLS certificate.
- Use an official or trusted payment module.
- Keep PrestaShop, payment modules, and server software updated.
- Store API secrets securely.
- Use the payment provider’s hosted checkout or tokenization features where appropriate.
- Never store card security codes or sensitive card details yourself.
- Restrict administrator access and use strong passwords.
Many payment providers handle sensitive card data directly, reducing the amount of payment information your store needs to process. Your business must still meet the security requirements applicable to its integration.
Step 8: Test the Payment Process
Before accepting real payments, test your checkout experience thoroughly.
Use the provider’s sandbox or test mode whenever available.
Verify the following:
- Customers can select the intended payment method.
- The checkout displays the correct order total.
- Successful payments create or update orders correctly.
- Failed and cancelled payments are handled properly.
- Payment confirmations and order emails work.
- Refunds and order status changes work as expected.
- Mobile checkout functions correctly.
Use the test scenarios and payment credentials documented by your provider. Do not use real customer card details for testing.
Once everything works correctly, switch to live credentials and live mode according to the provider’s instructions.
Step 9: Configure Cash on Delivery and Bank Transfers
Not every customer wants to pay online. Offering alternative payment methods may be useful for some stores.
Cash on Delivery
If your business accepts COD, install or enable a compatible COD module if one is not already available.
Configure any available options for eligible countries, shipping methods, order conditions, and additional charges. Confirm that your shipping provider supports COD and that your checkout clearly communicates the terms.
Bank Transfer
If you accept direct bank transfers, configure the relevant payment module and provide customers with clear payment instructions.
Explain how customers should identify their orders when making a transfer. Establish a process for verifying receipts and confirming payment before dispatching orders.
Common Payment Configuration Problems in PrestaShop
Payment Method Is Not Showing at Checkout
Check that the module is enabled and that the payment method is available for the customer’s country, currency, customer group, and order conditions. Also review any
