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:
- customers use this interface to place and cancel orders, and save or update stored credit or debit card information.
- merchants use this interface to configure the Plugin and manage orders, which includes these tasks:
- Capture an authorization (multiple partial captures are also supported).
- Reverse an authorization (full authorization is supported).
- Void a capture (partial void is supported).
- Refund a capture (standard and partial refunds are supported).
- Void a refund (partial void is supported).
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 theBusiness 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 theBusiness Centeris AUTHORIZED_PENDING_REVIEW or PENDING_REVIEW, the order is in review and the order status is set toPayment pending for review.
- When the decision status from theBusiness Centeris AUTHORIZED_RISK_DECLINED, the order is rejected and the order status is set toOrder 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 theBusiness Center. When the transaction is settled in theBusiness Center, the follow-on services initiated from PrestaShop Back Office are impacted.
- For sales:
- The entire authorized amount should be settled in theBusiness Centerwhen accepting the transaction. When the settlement is not performed in theBusiness 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 | 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 theBusiness Centerto 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.
Workflow
The reports are processed and orders are updated in PrestaShop as described in this
workflow:
- Orders with anAUTHORIZED_PENDING_REVIEWorAUTHORIZED_RISK_DECLINEDstatus are included in theps_cybersourceofficial_ordertable in the PrestaShop database.
- If a review is trigged for an order based on the profile rule in Decision Manager, aPayment pending for revieworder status displays for that order on the PrestaShop Back Office Orders page.
- The merchant uses theBusiness Centerto 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.
- 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 theBusiness Center, is retrieved, and the new status is updated asAUTHORIZEDorDECLINED. The updated order status displays in theps_cybersourceofficial_ordertable in the PrestaShop database.
- The original decision and the new decision are updated and displayed in theps_cybersourceofficial_conversion_detail_reporttable in the PrestaShop database.
- The order is updated asAwaiting paymentstatus 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).