Configuring Plugin Settings

Use PrestaShop Back Office to configure these settings:
  • General settings
  • Payment method settings
  • Fraud management settings
  • Report settings
  • Latin American country settings, if they apply
For details about these settings, see Configuration Settings.
To configure these settings, follow these steps:
  1. Open PrestaShop Back Office and select
    Modules > Module Manager
    from the Dashboard. The Module Manager page opens.
  2. Find the Plugin in the Payment section on the Module Manager page, or enter Cybersource Official in the Search field and click
    Enter
    .
  3. Click
    Configure
    . The Configure Cybersource Official page opens.
  4. Under each tab, enter your configuration information, and click
    Save
    .

Configuration Settings

This section describes the configuration settings for the Cybersource Official Plugin.

General Settings

Sandbox Mode
When sandbox mode is set to
Yes
, PrestaShop operates in sandbox (test) mode so that you can test new changes and conduct experiments.
When sandbox mode is set to
No
, PrestaShop operates in production (live) mode.
Merchant ID
This setting specifies the shop or store Cybersource Merchant ID, which is a unique Cybersource identifier for the merchant.
Merchant Key ID
This setting identifies a specific key or token provided by a payment gateway to authenticate and authorize the merchant's integration with the gateway.
Merchant Secret Key
This setting identifies a confidential or private key used for secure communication between the merchant's online store and a payment gateway.
Payer Authentication/3-D Secure
When this setting is set to
Yes
, customers may receive one-time-password (OTP) pop-ups when placing orders using credit cards. This enables the exchange of data between the merchant, card issuer, and, when necessary, the customer, to validate that the transaction is being initiated by the rightful owner of the account. This may be a requirement for the country in which you are trading.
Enhanced Logs
When this setting is set to
Yes
, logs are generated and can be accessed by selecting
Configure > Advanced Parameters > Logs
.
Payment Action
Use the drop-down menu to choose one of these transaction settings:
  • Authorize:
    when selected, this setting generates an authorize-only transaction for a customer order.
  • Sale:
    when selected, this setting generates a sale (bundled authorization and capture) transaction for a customer order.

Payment Settings

Card Payment
When this setting is set to
Yes
, customers can use a credit or debit card as a payment method.
Click to Pay
When this setting is set to
Yes
, customers can use Click to Pay as a payment method. When the setting is set to
Yes
, you must also provide a Click to Pay API key, which you can configure in the Cybersource
Business Center
.
Google Pay
When this setting is set to
Yes
, customers can use Google Pay as a payment method. When the setting is set to
Yes
, you must also enter the Google Pay Merchant ID and Google Pay Merchant Name, which you obtain from a Google Pay Developer account.
Apple Pay
When this setting is set to
Yes
, customers can use Apple Pay as a payment method. When the setting is set to
Yes
, you must also enter the Apple Pay Merchant ID, Path to Certificate (file), and Path to Key (file), which you obtain from an Apple Developer account. See Enabling Apple Pay for information about the requirements for enabling Apple Pay and generating these files.
eCheck
When this setting is set to
Yes
, customers can use
eCheck
as a payment method.

Fraud Management Settings

Fraud Management
When this setting is set to
Yes
, merchants can identify and prevent fraudulent activities that might occur when their customers are using PrestaShop.
Tokenization
When this setting is set to
Yes
, customers can safely save and store their card information so that it can be used for future purchases.
Enforce Strong Customer Authentication
When this setting is set to
Yes
, the card holder is 3-D Secure challenged when saving their card information.
The Enforce Strong Customer Authentication setting is available only when the Payer Authentication/3-D Secure (general Plugin setting) and Tokenization (fraud management Plugin setting) are enabled.
Limited Saved Card Rate
When this setting is set to
Yes
, merchants can specify the number of cards that customers can save in their account, and they can specify the amount of time for which that card information can be saved:
  1. Saved Card Limit Count:
    specifies the maximum number of cards a customer can save to their account.
  2. Saved Card Limit Time Frame:
    specifies the time frame (from 1 to 24 hours) for which customers can save the specified number of cards to their account.
Google reCAPTCHA
When this setting is set to
Yes
, merchants enter the Google reCAPTCHA keys, which are used to provide an advanced risk analysis engine and adaptive challenges to keep malicious software from engaging in abusive activities on your website:
  • reCAPTCHA Site Key
  • reCAPTCHA Secret key, which can be configured on the Google reCAPTCHA website
See Generating a Google reCAPTCHA Site Key and Secret Key for the steps on how to generate these keys.
Device Fingerprint
When this setting is set to
Yes
, merchants can identify and track devices that access their website such as computers, smart phones, and tablets.

Report Settings

Transaction Request Report
This report includes details for individual transactions that are processed each day.
When this setting is set to
Yes
, this report is downloaded from the
Business Center
to PrestaShop. The report is downloaded to different locations, depending on the mode in which PrestaShop is operating:
  • In sandbox (test) mode, the report downloads to
    {PrestaShopModuleInstallationDirectory}/cybersourceofficial/Reports/Sandbox
  • In production (live) mode, the report downloads to
    {PrestaShopModuleInstallationDirectory}/cybersourceofficial/Reports/Production
    .
Cybersource strongly recommends that PrestaShop and the
Business Center
operate in the same time zone so that the Transaction Request Report and Payment Batch Detail Report work properly.
Payment Batch Detail Report
This report includes transactions that are processed with the applications. This report is available shortly after captured transactions are batched.
When set to
Yes
, this report is downloaded from the
Business Center
to PrestaShop. The report is downloaded to different locations, depending on the PrestaShop mode:
  • In sandbox (test) mode, the report downloads to this location:
    {PrestaShopModuleInstallationDirectory}/cybersourceofficial/Reports/Sandbox
  • In production (live) mode, the report downloads to this location:
    {PrestaShopModuleInstallationDirectory}/cybersourceofficial/Reports/Production
Cybersource strongly recommends that PrestaShop and the
Business Center
operate in the same time zone so that the Transaction Request Report and Payment Batch Detail Report work properly.
Conversion Detailed Report
This report retrieves Case Management changes from the
Business Center
at regular intervals to ensure that orders are updated in PrestaShop.

Latin American Country Settings

Installments
When this setting is set to
Yes
, customers can make installment payments ranging from 1 to 24 months. You can configure installment payment settings for these Latin American countries: Brazil, Chile, Columbia, Mexico, and Peru. See Enabling Installment Payments for how to configure installment payments.
Merchant Descriptor Name
This configuration applies only to Brazil and Mexico.
This setting enables merchants to add a short description that appears on a customer credit card statement or bank statement to identify a particular transaction.
Grace Period
This setting stipulates a time period after a due date during which a payment can be made without incurring late fees or penalties. See Enabling Grace Period Payments for further information about configuring grace period payments for Mexico, the only country for which this setting currently applies.