Migrating Fraud Filter rules to Shopify Flow
To continue managing potentially fraudulent orders automatically, you need migrate your Fraud Filter rules to Shopify Flow.
Shopify Flow can provide you with the same functionality as the Fraud Filter app to manage potentially fraudulent orders. For example, you can create tasks, such as tag low- or medium-risk orders, or cancel high-risk orders automatically. Learn more about Shopify Flow. Shopify Flow is available to merchants that are on the Basic, Shopify, Advanced, or Shopify Plus plan.
On this page
- Considerations for migrating your Fraud Filter rules to Shopify Flow
- Migrate Fraud Filter rules to Shopify Flow automatically
- Review automatically migrated Fraud Filter rules in Shopify Flow
- Export incompatible Fraud Filter rules to a CSV file
- Migrating Fraud Filter rules manually
- Fraud Filter and Shopify Flow field mapping
Considerations for migrating your Fraud Filter rules to Shopify Flow
Before you migrate your Fraud Filter rules to Shopify Flow, review the following considerations:
- You can automatically migrate only those Fraud Filter rules that were used in an order in the last 12 months. If a rule hasn't been used in the last 12 months, then you need to migrate your rules manually by creating workflows in Shopify Flow.
- Some Fraud Filter fields aren't supported in Shopify Flow and can't be migrated to Shopify Flow. You can export rules that have incompatible fields to a CSV file during migration for future reference.
- You can't choose which Fraud Filter rules to migrate automatically. You can only migrate all rules at the same time.
Migrate Fraud Filter rules to Shopify Flow automatically
You can migrate compatible Fraud Filter rules to Shopify Flow automatically.
When you migrate your rules, all your rules are migrated to a single Shopify Flow workflow by default, unless you exceed the 500 maximum workflow step count. In this case, you rules are migrated into multiples workflows in Shopify Flow.
Steps:
From your Shopify admin, go to Settings > Apps and sales channels.
Click Fraud Filter.
Click Open app.
Optional: If you don't have the Shopify Flow app installed, then from the Rules page, click Install Flow.
Go back to Fraud Filter > Rules.
From the Rules page, click Move rules.
After the migration process is complete, you receive a notification alert in your Shopify admin.
Review automatically migrated Fraud Filter rules in Shopify Flow
After you migrate your rules, you can review each rule in Shopify Flow and make sure that your rules work as intended.
Steps:
From your Shopify admin, go to Settings > Apps and sales channels.
Click Fraud Filter.
Click Open app.
From the Rules page, click a rule that you want to preview, and then click Open Flow.
Review the workflow and make sure that the rule was migrated to Shopify Flow correctly.
Export incompatible Fraud Filter rules to a CSV file
Some Fraud Filter rules can't be migrated automatically to Shopify Flow due to the following reasons:
- A Fraud Filter field isn't supported in Shopify Flow
- A Fraud Filter rule has incorrect field and operator combinations.
- A Fraud Filter rule hasn't be used in the last 12 months. You need to migrate these rules manually by creating workflows in Shopify Flow.
If your rules can't be migrated automatically, then you can export incompatible rules to a CSV file. The exported CSV file includes the action the rule takes, the rule field type, and the reason why a rule can't be migrated to Shopify Flow automatically. This CSV file is only for future reference use and isn't meant to be imported to Shopify Flow.
You can't export specific incompatible Fraud Filter rules, you can only export all rules at once.
Steps:
From your Shopify admin, go to Settings > Apps and sales channels.
Click Fraud Filter.
Click Open app.
From the Rules page, click Export rules to export incompatible rules to a CSV file.
Migrating Fraud Filter rules manually
You can migrate your Fraud Filter rules manually by creating workflows in Shopify Flow. When migrating rules manually, make sure to refer to the Fraud Filter and Shopify Flow field mapping.
Review the following common Shopify Flow workflows for managing potentially fraudulent orders:
- Capture an order that isn't high fraud risk
- Cancel and restock high-risk orders
- Cancel orders for customers who frequently return items
- Cancel and tag orders from known bad email addresses
Learn more about managing high-risk orders with Shopify Flow.
Fraud Filter and Shopify Flow field mapping
You might need to create workflows in Shopify Flow manually for your Fraud Filter rules that are incompatible to migrate to Shopify Flow.
Review the following table that maps Fraud Filter fields to corresponding fields in Shopify Flow:
| Fraud Filter field | Shopify Flow field |
|---|---|
| Accept language | order.customerLocale |
| AVS code | transactions_item.paymentDetails.CardPaymentDetails.avsResultCode |
| Billing Address City | order.billingAddress.city |
| Billing Address Company | order.billingAddress.company |
| Billing Address Country code | order.billingAddress.countryCodeV2 |
| Billing Address First name | order.billingAddress.firstName |
| Billing Address Latitude | order.billingAddress.latitude |
| Billing Address Last name | order.billingAddress.lastName |
| Billing Address Longitude | order.billingAddress.longitude |
| Billing Address Phone | order.billingAddress.phone |
| Billing Address State/Province | order.billingAddress.province |
| Billing Address State/Province code | order.billingAddress.provinceCode |
| Billing Address Street 1 | order.billingAddress.address1 |
| Billing Address Street 2 | order.billingAddress.address2 |
| Billing Address Zip/Postal | order.billingAddress.zip |
| Browser IP | order.clientIp |
| CVV code | transactions_item.paymentDetails.CardPaymentDetails.cvvResultCode |
| Credit card company | transactions_item.paymentDetails.CardPaymentDetails.company |
| Credit card number | transactions_item.paymentDetails.CardPaymentDetails.number |
| Customer ID | order.customer.id |
| Customer first Name | order.customer.firstName |
| Customer last Name | order.customer.lastName |
order.email | |
| Landing site | order.customerJourneySummary.firstVisit.landingPageHtml |
| Order(s) count | order.customer.numberOfOrders |
| Referring site | order.customerJourneySummary.firstVisit.referralInfoHtml |
| Session hash | Not supported |
| Shipping Address City | order.shippingAddress.city |
| Shipping Address Company | order.shippingAddress.company |
| Shipping Address Country code | order.shippingAddress.countryCodeV2 |
| Shipping Address First name | order.shippingAddress.firstName |
| Shipping Address Latitude | order.shippingAddress.latitude |
| Shipping Address Last name | order.shippingAddress.lastName |
| Shipping Address Longitude | order.shippingAddress.longitude |
| Shipping Address Phone | order.shippingAddress.phone |
| Shipping Address State/Province | order.shippingAddress.province |
| Shipping Address State/Province code | order.shippingAddress.provinceCode |
| Shipping Address Street 1 | order.shippingAddress.address1 |
| Shipping Address Street 2 | order.shippingAddress.address2 |
| Shipping Address Zip/Postal | order.shippingAddress.zip |
| Subtotal price | order.currentSubtotalPriceSet.presentmentMoney.amount |
| Total price | order.totalPriceSet.presentmentMoney.amount |
| User agent | Not supported |