On This Page

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:
Saved Card Limit Count:
specifies the maximum number of cards a customer can save to their account.
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.