PrestaShop
The plugin for PrestaShop provides a payment solution for merchants using PrestaShop
to manage their orders. This section describes the payment methods and services the
plugin provides.
Supported payment methods:
- Credit and debit cards
- eCheck
- Click to Pay
- Apple Pay
- Google Pay
Supported payment services:
- Payment acceptance services:
- Authorization only
- Sale (bundled authorization and capture)
- Electronic check debit (sale) foreCheckpayment method
- Installment payments for Brazil, Chile, Colombia, Mexico, and Peru
- Grace period payments for Mexico
- Order management services:
- Capture an authorization (not foreCheck)
- Multiple partial captures (not foreCheck)
- Standard and partial refunds
- Standard and partial void captures (not foreCheck)
- Standard and partial void refunds
- Full authorization reversal (not foreCheck)
- Token Management Service(TMS) for credit and debit card payments:
- Create payment token along with authorization
- Update an existing token along with authorization
- Update an existing token from My Account section
- Delete an existing token from My Account section
- Create payment token for new payment methods during checkout
- Make a payment with a stored token during checkout
- Reporting services that allow you to import these CybersourceBusiness Centerreports into PrestaShop:
- Transaction Request Report
- Payment Batch Detail Report
- Conversion Detail Report
Release Information
This section provides information about the plugin
releases.
Release Version | Release Date | Support End Date |
---|---|---|
2.1.0 | April 5, 2022 | September 29, 2022 |
3.1.0 | September 29, 2022 | April 5, 2022 |
4.1.0 | September 21, 2023 | July 2026 |
4.2.0 | December 13, 2023 | December 13, 2026 |
Version 4.2.0 includes the following enhancements:
- Cybersource authentication signature updated.
- Compatible with PrestaShop versions 1.7.6.0 to 1.7.8.10
Version 4.1.0 includes enhancements that provide customers with a flexible and
convenient purchasing experience:
- Installment payment options for customers in Mexico, Brazil, Colombia, Chile, and Peru. This feature enables customers to conveniently split their payments into installments.
- Grace period payment options for customers in Mexico. This feature enables customers to delay a payment for a specified period after making a purchase.
- Expanded card payment services, which includes credit and debit card options. This feature enables customers to securely make payments using their preferred card type.
Installation
Before you install the plugin, make sure that these requirements are met:
- You are using PrestaShop version 1.7.x.
- You have created aBusiness Centeraccount and have generatedBusiness CenterREST API keys:
- To create an account, go to the Business Center Registration website.
- To generate REST API keys, seeGetting Started with REST Developer Guide.
- You have created an Apple Developer account if you are processing Apple Pay transactions.
- You have created an Google Pay Developer account if you are processing Google Pay transactions.
Follow these steps to install the plugin:
- Download the Plugin from the PrestaShop website to your local system.PrestaShop Modules > Payments > Other Payments > Cybersource Official
- Open PrestaShop Back Office and chooseModules > Module Managerfrom the Dashboard.The Module Manager page opens.
- ClickUpload a Moduleon the Module Manager page.The Upload a module pane appears.
- Clickselect filefrom the Upload a module pane and select the file you downloaded to your local system. You can also drag the file into the Upload a module pane.The pane displays the status of the installation. After the Plugin is installed, the pane indicates that the module is installed. You can close it or clickConfigureto configure the Plugin.
Configuration
This section describes how to set up the plugin. You
complete most of the Plugin configuration using PrestaShop Back Office.
- For information about the configuration settings for the Plugin, see Configuration Settings.
- For information about how to access the configuration settings for the Plugin, see Configuring Plugin Settings
When merchants support digital payment processing using Apple Pay or Google Pay, they must
complete some setup using the Apple Pay or Google Pay Developer websites.
Using the Plugin
The plugin provides merchants a frictionless way to process
payments, prevent fraud, and generate
reports within the
Business Center
while making it easy for customers to place and cancel orders, and save or update stored credit or
debit card information.Testing
If you have not done so already, configure these settings
using PrestaShop Back Office. See Configuring Plugin Settings for
information about how to access these settings:
- General Settings:merchant ID, merchant key ID, and/or merchant secret key
- Payment Settings:applicable payment methods
After configuring the Plugin, complete this task to test the configuration using
PrestaShop Front Office to place an order and PrestaShop Back Office to manage the
order.
- Open PrestaShop Front Office to place an order.
- Enter any required personal information and select the payment method that you want to use to place the order.
- Enter the card information you want to use to place the order and clickPay. If the order is successful, an order confirmation message displays.
- Open PrestaShop Back Office to manage the order.
- SelectOrders > Ordersfrom the Dashboard. The Orders page displays and lists all active orders.
- Select and open the order you processed in Step 1. The order status for the order should displayAwaiting payment.
- ClickStandard Captureicon to capture the authorized amount, and clickYesto capture the entire order. The order status changes toPayment accepted.
- ClickStandard Refundto refund the full captured amount. The order status changes toRefunded.
- ClickVoid Refundto void the refunded amount. The order status changes toRefund cancelled.For more information about testing, including test cards, see
Upgrading
You can install a newer version of the plugin
using PrestaShop Back Office.
- Open PrestaShop Back Office and selectImprove > Modules > Module Managerfrom the Dashboard.
- Click the arrow next to the pluginConfigureicon and chooseUpgradefrom the drop-down menu.
Troubleshooting
This section might help you resolve specific issues that can occur during the
installation and upgrade processes for the plugin.
Issue: PrestaShop Language Pack Installation Error
You get a
1: Cannot download language pack "en"
error message when installing
the Plugin. To resolve this issue, complete these steps:
- Locate and open theTools.php file, which resides inhtdocs/PrestaShop root/Classesdirectory on your system.
- Search for and select this string in the Tools.php file:curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
- Replace the selected string with this string:curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, true);
- Save the file and reload your browser page.
Issue: Debug Mode is Enabled in Production
When debug mode is enabled in the production instance, you need to disable it.
- Open PrestaShop Back Office and selectConfigure > Advanced Parametersfrom the Dashboard. The Advanced Parameters page appears.
- SelectPerformancefrom the Advanced Parameters page.
- Set Debug mode toNo.
Issue: User Interface Appears Incorrectly After a Plugin Upgrade
After upgrading the Plugin, if the user interface looks incorrect, you need to clear
the cache.
- Open PrestaShop Back Office and selectConfigure > Advanced Parametersfrom the Dashboard. The Advanced Parameters page appears.
- From the Advanced Parameters page, clickPerformance.
- ClickClear Cache.