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.

Order Management

This section describes the order management process that occurs after a customer places an order.
The order management process is handled using these PrestaShop office interfaces:

Customer Tasks

Customers can use the My Account option on the merchant's PrestaShop website to manage orders and their payment information. The following sections contain the steps to complete these tasks.

Merchant Tasks

Merchants use PrestaShop Back Office to manage orders. This section describes the steps to complete these tasks.

Fraud Management

The plugin provides fraud management functionality for merchants who also use the Cybersource
Business Center
. You can apply fraud management functionality to transactions in these situations:
  • Fraud management is enabled in the plugin.
  • You have a fraud management profile in the
    Business Center
    .
Fraud screening includes these features:
  • Fraud Management Essentials (FME):
    used to enforce the rules created by the Cybersource Machine Learning System (MLS). Fraud management is used to define the merchant’s rules.
  • Fraud Management Rules:
    • When the decision status from the
      Business Center
      is AUTHORIZED_PENDING_REVIEW or PENDING_REVIEW, the order is in review and the order status is set to
      Payment pending for review
      .
    • When the decision status from the
      Business Center
      is AUTHORIZED_RISK_DECLINED, the order is rejected and the order status is set to
      Order cancelled by merchant
      .
The table below describes the possible decisions, outcomes, and timing that Decision Manager uses when an order is triggered for review.
When the following transactions are in a Decision Manager review state, certain settlement considerations apply:
  • For authorizations:
    while accepting this transaction it is not recommended to settle it in the
    Business Center
    . When the transaction is settled in the
    Business Center
    , the follow-on services initiated from PrestaShop Back Office are impacted.
  • For sales:
    • The entire authorized amount should be settled in the
      Business Center
      when accepting the transaction. When the settlement is not performed in the
      Business Center
      , the follow-on services initiated from PrestaShop Back Office fail.
    • A follow-on void capture will not initiate from PrestaShop Back Office. While accepting review transactions, merchants should not select the settle option.
Decision Manager Decisions, Execution Timings, and Outcomes for Orders
Decision
Execution Timing
Outcome of Decision
Monitor
Before authorization
Authorization is successful and no action from the Decision Manager is required. Use this decision to understand the outcome of a rule.
Accept
Before authorization
The order is processed normally and is placed successfully.
Review
Before authorization
The authorization is successful, and follow-on services are put on hold until the merchant accepts or rejects it. The order status is set to
Payment pending for review
.
Reject
Before authorization
The order is rejected and the authorization is not processed. The merchant is not able to view the order in PrestaShop Back Office.
Monitor
After authorization
The authorization is successful and no action from Decision Manager is required. Use this decision to understand the outcome of a rule.
Accept
After authorization
The order is processed normally and placed successfully.
Review
After authorization
The authorization is successful, and follow-on services are put on hold until the merchant accepts or rejects it. The order status will be set to
Payment pending for review
.
Reject
After authorization
The original authorization is successful and then is automatically reversed and the order status is set to
Order cancelled by merchant
.

Reporting

The plugin provides reporting functionality for merchants who also use the
Business Center
. You can import these reports from the
Business Center
into PrestaShop:
  • Transaction Request Report:
    includes details for individual transactions that are processed each day.
  • Payment Batch Detail Report:
    includes transactions that are processed with the applications. This report is available shortly after captured transactions are batched.
  • Conversion Detail Report:
    includes Case Management changes recorded in the
    Business Center
    to ensure that updated orders are also included in PrestaShop. This report is generated at regular intervals and includes the results of the converted orders for each reviewer. This information provides an overview of all orders that were not immediately accepted.

Scheduling

The Plugin reporting functionality works with a system scheduler to generate and update reports for PrestaShop. There are some Cron Job modules available for PrestaShop, such as the Cron Tab, that support reporting. Merchants can use any Cron Job module that PrestaShop supports or any other online Cron service provider to generate reports.
See Scheduling Report Generation for information about how to schedule report generation.

Workflow

The reports are processed and orders are updated in PrestaShop as described in this workflow:
  1. Orders with an
    AUTHORIZED_PENDING_REVIEW
    or
    AUTHORIZED_RISK_DECLINED
    status are included in the
    ps_cybersourceofficial_order
    table in the PrestaShop database.
  2. If a review is trigged for an order based on the profile rule in Decision Manager, a
    Payment pending for review
    order status displays for that order on the PrestaShop Back Office Orders page.
  3. The merchant uses the
    Business Center
    to accept the order that is in review, and, if not already enabled, the merchant enables the reports using the Report Settings on the Plugin Configuration page.
  4. The scheduler runs the report at regular intervals according to the intervals the merchant configured. The order is accepted or rejected by the merchant in the
    Business Center
    , is retrieved, and the new status is updated as
    AUTHORIZED
    or
    DECLINED
    . The updated order status displays in the
    ps_cybersourceofficial_order
    table in the PrestaShop database.
  5. The original decision and the new decision are updated and displayed in the
    ps_cybersourceofficial_conversion_detail_report
    table in the PrestaShop database.
  6. The order is updated as
    Awaiting payment
    status for the authorization and displayed on the PrestaShop Back Office Orders page. The payment is accepted for the sale and any associated follow-on transactions (capture, void capture, refund, void refund, and full authorization reversal).