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) for
      eCheck
      payment method
    • Installment payments for Brazil, Chile, Colombia, Mexico, and Peru
    • Grace period payments for Mexico
  • Order management services:
    • Capture an authorization (not for
      eCheck
      )
    • Multiple partial captures (not for
      eCheck
      )
    • Standard and partial refunds
    • Standard and partial void captures (not for
      eCheck
      )
    • Standard and partial void refunds
    • Full authorization reversal (not for
      eCheck
      )
  • 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 Cybersource
    Business Center
    reports 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.
PrestaShop

Installation

Before you install the plugin, make sure that these requirements are met:
Follow these steps to install the plugin:
  1. Download the Plugin from the PrestaShop website to your local system.
    PrestaShop Modules > Payments > Other Payments > Cybersource Official
  2. Open PrestaShop Back Office and choose
    Modules > Module Manager
    from the Dashboard.
    The Module Manager page opens.
  3. Click
    Upload a Module
    on the Module Manager page.
    The Upload a module pane appears.
  4. Click
    select file
    from 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 click
    Configure
    to configure the Plugin.
PrestaShop

Configuration

This section describes how to set up the plugin. You complete most of the Plugin configuration using PrestaShop Back Office.
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.
PrestaShop

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.
PrestaShop

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.
  1. Open PrestaShop Front Office to place an order.
  2. Enter any required personal information and select the payment method that you want to use to place the order.
  3. Enter the card information you want to use to place the order and click
    Pay
    . If the order is successful, an order confirmation message displays.
  4. Open PrestaShop Back Office to manage the order.
  5. Select
    Orders > Orders
    from the Dashboard. The Orders page displays and lists all active orders.
  6. Select and open the order you processed in Step 1. The order status for the order should display
    Awaiting payment
    .
  7. Click
    Standard Capture
    icon to capture the authorized amount, and click
    Yes
    to capture the entire order. The order status changes to
    Payment accepted
    .
  8. Click
    Standard Refund
    to refund the full captured amount. The order status changes to
    Refunded
    .
  9. Click
    Void Refund
    to void the refunded amount. The order status changes to
    Refund cancelled
    .
    For more information about testing, including test cards, see
PrestaShop

Upgrading

You can install a newer version of the plugin using PrestaShop Back Office.
  1. Open PrestaShop Back Office and select
    Improve > Modules > Module Manager
    from the Dashboard.
  2. Click the arrow next to the plugin
    Configure
    icon and choose
    Upgrade
    from the drop-down menu.
PrestaShop

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:
  1. Locate and open the
    Tools.php file
    , which resides in
    htdocs/PrestaShop root/Classes
    directory on your system.
  2. Search for and select this string in the Tools.php file:
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
  3. Replace the selected string with this string:
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, true);
  4. 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.
  1. Open PrestaShop Back Office and select
    Configure > Advanced Parameters
    from the Dashboard. The Advanced Parameters page appears.
  2. Select
    Performance
    from the Advanced Parameters page.
  3. Set Debug mode to
    No
    .

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.
  1. Open PrestaShop Back Office and select
    Configure > Advanced Parameters
    from the Dashboard. The Advanced Parameters page appears.
  2. From the Advanced Parameters page, click
    Performance
    .
  3. Click
    Clear Cache
    .
PrestaShop