Layer 1 copy

Overview

This tutorial will teach you how to set up a Workflow in the Sift Science Console. It will include an explanation of testing a new Workflow, and then moving the Workflow to production.

Workflows enable you to make risk-based decisions on users at your key decision points, like this:

Creating a new Workflow

The steps involved in creating a new Workflow are the following:

  1. Choose a triggering event, entity to act on, and fraud type.
  2. Create routes and set the business actions to be taken.
  3. Enable your Workflow for testing.
  4. Enable your Workflow for production automation.

Creating a new Workflow

To create a new Workflow in the Sift Science console, first navigate to the Automation Tab. The Workflows section should be brought up by default. Click on the “Add a new Workflow” button to begin creating the Workflow.

Choosing a triggering event

The next step is to choose an event trigger. This dictates what key action taken by your customers will trigger this flow. Click on the dropdown to choose an event, such as “Create Order” or “Create Account.” These events correspond to the reserved and custom events you send Sift Science.

Choosing an entity to act on

Now you will choose the entity on which this flow will operate. This can either be a User (account) or Order. If you want the actions of this Workflow to be taken on the account level, choose User. If you want the actions to be taken on the order, choose Order. Choose this from the drop down beneath the triggering event.

Choosing abuse types

The next step is to choose the type of abuse that this flow is intended to prevent. The available abuse types are Payment Abuse, Promo Abuse, Content Abuse, and Account Abuse. A single workflow may have multiple associated abuse types.

Once you’ve done this, click the button to move on to step 2, building your routes.

Configuring your Workflow routes

Before You Start

Before you start to configure your Workflow routes, we suggest scoping out the different business actions you would like this Workflow to take (blocking an order, suspending an order, banning an account, etc.). Then, read our Connecting Decisions to Business Actions tutorial to learn how to create new Decisions.

Now you’re ready to add routes to your Workflow. Think of each route as a set of criteria that leads to some specific Decision (i.e. blocking an order, banning an account) or that sends a user/order to a review queue.

Adding criteria to a route

In order to add criteria to a route you’re working on, click the “Add Criteria” button. Choose some criteria that you wish to evaluate for this route. You can add multiple criteria to a single route. Criteria can be any field sent to Sift Science (reserved or custom), or the latest Decision that was taken on the user/order.

Route Criteria

A route will only be true if the user matches all criteria in the route. So in the following image, this route will be true if the user has a Payment Abuse score greater than 75, has at least 5 other users using the same device, does not have a matching billing/shipping address, and is using the gmx.com email domain.

Adding an action to a route

Next you will choose the action that should be taken if the user/order matches the criteria of this route. This action could either add the user/order to a manual review queue, or trigger a Decision (actions that triggers Decision webhook notification to your backend).

Sending a User/Order to a review queue

Reviewing outside of the Sift Science console?

If you would like to send the user/order to a review queue outside of Sift, read our Connecting Decisions to Business Actions tutorial and create a new Decision for which the business action is adding the user/order to your external review queues.

You can choose the review queue to which you want to add this user/order in the dropdown menu. If you have not set up a manual review queue yet, or wish to create a new review queue, you will be able to through the “create a new queue” button. In order to create a review queue you need to fill in a few details:

  • Name - The name of the review queue, such as “High priority chargebacks queue”.
  • Timeout - This is a set amount of time that a user/order can sit in the review queue unreviewed before an automated Decision is taken.
  • Timeout Decision - This is the automated Decision you wish to have taken if the user/order waits in the review queue for longer than the maximum time. For example you could automatically block any orders you do not have time to review, or you could automatically accept them.
  • Available Queue Decisions - You can choose which Decisions are available to the reviewers in the review queue. For example the chargebacks review queue may have the “Block Order”, “Accept Order”, and “Request To Contact Support” Decisions available to it. A promotion abuse queue might have the “Ban Account” and “Request To Contact Support” Decisions available.

Once you have chosen all of these details, click “Save” to create your review queue.

Triggering an automated Decision

You can choose the “Set Automated Decision” button to choose an automated action that should be taken on the user/order which matches a specific route. Choose an existing Decision from the list, or create a new one by clicking the “Create New Decision” option. To learn how to create a new Decision, please read our Connecting Decisions to Business Actions tutorial.

Creating additional routes

To create an additional route, click the “add another route” button and repeat the steps above.

Setting a default action

In each workflow you must set an action that will be taken on any user/order who does not match any of the other routes. This can be sending them to a review queue or taking an automated action.

Finally, save your new Workflow.

Connecting the Workflow output to your backend

In order for the Decisions you make in your new Workflow to be executed, you need to make some minor integration changes to consume the output of your Workflows.

If you want to consume the action that was taken by the Workflow synchronously, please read the documentation on Synchronously Requesting Flow Status and implement it on the triggering event for this Workflow. This is useful for time sensitive Workflows such as deciding to accept and order and process the payment instrument, or reject/hold it.

If you want to consume the action that was taken by the Workflow asynchronously, follow the instructions in the Connecting a Decision section of the Connect Decisions to Business Actions tutorial regarding webhooks. This is useful for Decisions that are taken by your operations team in our Manual Review Queues, or any action is not time sensitive.

Enabling your Workflow

Once you have tested your Workflow and are satisfied with the configuration, you can put it in action by clicking the Off/On switch in the top right of your workflow

Once this is switched on, your Workflow will be executed on every $create_order that is sent to Sift Science and will apply the desired actions.

Testing your new Workflow

Initially when you enable your new Workflow, you may want to spend some time testing it and verifying that it performs the way you expect. In order to do this make sure that your Decisions, whether they are triggered automatically or by your operations team, do not actually execute the action but just log what Decision was made. This way you can see how many orders/users you will block/accept/etc. based on this Workflow.

Using your Workflow in production

Once you are ready to use your Workflow in production, connect the Decisions to actual business actions on your backend (Blocking/Accepting/etc.). You will now be automating with Sift Science!