Product Manual

Your one-stop shop for the details of everything related to our solution.

Magento Extension v2.0

This guide applies to version 2.0 of our Magento 2 extension.

The Magento 2.0 extension is available for our Mid-Market and Enterprise plans. 

Overview

Signifyd’s Magento app enables merchants on Magento 2 to integrate with Signifyd, automating fraud prevention and protecting them in case of chargebacks.

Specifically, Magento merchants can:

  • Automatically send orders to Signifyd for fraud prevention and chargeback protection on all their orders
  • Configure order workflows based on Signifyd’s guarantee decision
  • View the Signifyd guarantee decision and score within the Orders grid

How It Works

When an order is placed on your Magento store, Signifyd immediately places the order on hold to determine if it's fraudulent.

Within seconds, we'll tell you whether you should accept and ship the order (Approved), or cancel and not ship the order (Declined). The decision is displayed in the "Guarantee Status" column in the Magento Orders grid, and links to the case details within the Signifyd console.

If an order is Approved for Guarantee, Signifyd will unhold the order and update the order status to Pending within the Orders grid. (Please note that Signifyd can't send out any emails to this effect.) Signifyd can also simply leave the order on hold, if the merchant prefers.

If an order is Declined for Guarantee, Signifyd will leave the order on hold, allowing the merchant to decide if they choose to cancel the order, or ship without chargeback protection.

Signifyd Decision Magento Action
Approve Unhold the order, and update order status to Pending, OR,

Leave order on hold

Decline Leave order on hold

Within the order's Comments History, you can view a history of all the updates Signifyd has made to an order. Below are examples of how Signifyd updates an order, using both an example of an approved order and a declined order.

Approved Orders

Screen Shot 2017-04-21 at 3.43.28 PM

Screen Shot 2017-04-21 at 3.43.06 PM

In the above scenario, the order was submitted and immediately placed on hold. Within seconds, Signifyd approved the order, unheld it, and updated the order status to Pending. The Signifyd Guarantee Status was updated to Approved.

Declined Orders

Screen Shot 2017-04-21 at 3.43.47 PM

Screen Shot 2017-04-21 at 3.44.09 PM

In the above scenario, the order was submitted and immediately placed on hold. Within seconds, Signifyd determined the order to be fraudulent, and left the order on hold. The Guarantee Status was updated to Declined.

Installation

Successfully setting up Signifyd involves installing and configuring the extension.

To install the Signifyd extension navigate to System > Web Setup Wizard.

*Note: You must first order the extension from the Magento Marketplace. You also need access to the admin dashboard to complete the installation process.

Accessing the Web Setup Wizard menu in Magento 2

From the Magento Setup Tool grid select "Component Manager".

Accessing the Component Manager in Magento 2

From the Component Manager screen, you will see already installed extensions on your store, new extension updates, and or new extensions ready to be installed. To install the Signifyd extension click on the "Install" link below the "New Purchases" section.

Viewing the Available for Installation Extensions

Find the Signifyd extension from the extension grid and click the "Install" link to begin the installation process.

Screen Shot 2016-04-15 at 2.22.42 PM (1).png

Click "Start Readiness Check" which will check if your Magento 2 installation has all of the necessary components required for installation.

Starting a Readiness Check

If your store passes the readiness check you will be prompted to move to the next step. Select the "Next" button to proceed to step 2.

*If your store does not meet a specific requirement the component will be marked in red. You can then view additional details and how to fix the issue by selecting the provided links.

Successfully completing a Readiness Check

We recommend you run a backup before installing any extension. To perform a backup select "Create Backup". If you have already performed a backup you can de-select the backup options and click on the Next button.

Creating a Backup before the extension install

If you select to create a backup, you will receive a confirmation screen that the backup has been successfully created. Select the "Next" button to proceed.

Completing the Backup creation step

Click on the "Install" button to install the Signifyd extension.

Screen Shot 2016-04-15 at 2.25.03 PM.png

Once the installation has been completed, you will receive a confirmation and the ability to go back by clicking on the "Back to Setup Tool" button.

Configure the app

Accessing the Settings Page

To access the Signifyd extension select "Stores" from the admin sidebar then "Configuration".

Screen Shot 2016-04-06 at 11.31.47 AM.png

While on the configuration page select "Services" to expand the drop-down menu. Then from the drop down menu select "Signifyd" to access the Signifyd settings page.

Screen Shot 2016-04-06 at 11.34.56 AM.png

Settings Overview

The settings page is broken into 4 areas: General Settings, Advanced Settings, Webhook URL, and Logging. Under general settings, you can enable or disable the Signifyd extension for your store. This is also where the API key is configured during the installation process.

Advanced Settings

Under advanced settings, you can configure workflow actions to automate order processing based on Signifyd's guarantee decision. You can select to "unhold" an order when Signifyd provides a guarantee decision of "Approved" automating the fulfillment of Guaranteed orders.

screen_shot_2016-11-14_at_12_13_20_pm

Webhook URL
Webhooks are used to push Signifyd's guarantee decision back to Magento and enable a two-way sync between Magento and Signifyd.
  • To configure a webhook: copy the URL from the Webhook URL setting. You'll need this to complete the configuration in the next step.
  • Then navigate to the Signifyd console, settings, and then click on Notifications.
In the Webhooks section, complete the following steps:
  • In the Webhook address field, paste the Webhook URL you copied from your Magento Admin panel
  • In the Team dropdown, select the test team you just created
  • In the Event Type dropdown, select Guarantee Completion
Finally, click Add to save the webhook.
screen-shot-2016-10-21-at-10-51-39-am-2
screen-shot-2016-10-21-at-10-51-56-am-2

Logging

Under logs, you can enable the logging of various services. We recommend to always enable logging. In the event of an issue, logging helps our support team troubleshoot and resolve issues quickly.