{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","site-link"]},"type":"markdown"},"seo":{"title":"Lists","meta":[{"name":"robots","content":"noindex, nofollow"},{"name":"pingdom","content":"sh3MDv8mJpWhCWSTdGtN"}]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"lists","__idx":0},"children":["Lists"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fraud Lists offer a clearer overview and facilitate the handling of criteria used for fraud protection. Rather than creating numerous Fraud Rules for specific types of values, you can simply establish a single Fraud Rule that applies to the values from a Fraud List. The default view of the Fraud Lists consists of Lists created by Shift4. They cannot be deleted. System Lists can be extended by adding values from a charge view or customer view"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/lists-page-system-lists.4090a458688af6f2a57bcacfb62ec7f51cb591030ebd2172392c5f697b714cca.add7c583.png","alt":"The Lists page in the dashboard on the System lists tab, showing Shift4-created approve and decline lists for card BIN, card country, card fingerprint, card issuer, email and IP address, each with 0 values and applied to rules"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merchants can also create their own Fraud Lists."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/lists-page-user-lists.93f05ee97969fdf1d1f8147f133a6cfad2973fa27f4bf4fb9d6e2671ecb775de.add7c583.png","alt":"The Lists page on the User lists tab, showing two merchant-created lists named IP hotels and Special clients, both with 0 values and not applied to any rules"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please note that in case of system Fraud Lists, items added to the Approve List cannot be included in the Decline List. For example, you cannot pre-approve and ban an email address at the same time."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please note that Fraud Lists and Fraud Rules are not retroactive, meaning they only apply to charges created after the introduction of the rule or the addition of an item to the list. Charges that have been declined or approved based on the fraud rule will retain their status, even if the rule is later edited or deleted."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-add-a-custom-fraud-list","__idx":1},"children":["How to Add a Custom Fraud List"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to the ",{"$$mdtype":"Tag","name":"SiteLink","attributes":{"href":"/fraud-lists"},"children":["Fraud"]}," on the left side panel, then select Lists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add List"]}," button located in the upper right corner."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a data type that should be stored in the List. Select String as a criterion for Fraud Rules processing metadata."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},". A new List should now be visible on the main view."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To populate the List, simply click on it and then use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Value"]}," button."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you add an item to the List, you can expand it with a new value and review the existing values and associated Fraud Rules. Additionally, you can easily edit the List's name by using the context menu next to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Value"]}," button."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/list-page2.a2aad50d7caeec71a064b9b8ed45a63828b95d552fe660b6d6211ce9ef81f92f.add7c583.png","alt":"The Email decline list detail page showing list details with alias email_decline_list and type E-mail, a related Decline rule, and one value customer@example.com added to the list"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-delete-a-custom-fraud-list","__idx":2},"children":["How to Delete a Custom Fraud List"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order to delete a List, make sure it is not used in a Fraud Rule."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to the ",{"$$mdtype":"Tag","name":"SiteLink","attributes":{"href":"/fraud-lists"},"children":["Fraud"]}," on the left side panel, then select Lists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a List you'd like to delete."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click on the three horizontally aligned dots at the end of a line and choose option ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]}," on the on-screen communicate."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-add-a-value-to-a-fraud-list-from-the-charge-view","__idx":3},"children":["How to Add a Value to a Fraud List From the Charge View"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"SiteLink","attributes":{"href":"/charges"},"children":["Charges"]}," on left side panel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click on the selected charge."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add To List"]}," button in the upper right corner."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a field to which a Fraud Rule should be applied, and specify the type of Rule (Approve or Decline). There are no limitations on the number of fields you can pre-approve or ban in the same action."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/charge-page.dd40c5c8cdf40c0c133310b6f33f60f76c6baafa61de8e4e4c8d28fa6724ca30.add7c583.png","alt":"A successful 24.99 USD charge page with the Add to list dropdown open, offering to add the card fingerprint, customer email or IP address to a decline or approve list"},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once you confirm the changes by clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," at the bottom of the modal, new items will appear on respective default Fraud Lists. You can select a field from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]},"; if there is no custom List available for this field, one will be automatically created and populated. Note: if you choose to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}," as a criterion for a Fraud Rule, a new system Fraud List will be created. Like other Lists created by Shift4, this new List cannot be removed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-add-a-value-to-the-fraud-list-from-the-customer-view","__idx":4},"children":["How to Add a Value to the Fraud List From the Customer View"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"SiteLink","attributes":{"href":"/customers"},"children":["Customers"]}," on the left-side panel."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click on the selected customer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add To List"]}," button in the upper right corner. Customer email address will be added to a system Approve or Decline List."]}]}]},"headings":[{"value":"Lists","id":"lists","depth":1},{"value":"How to Add a Custom Fraud List","id":"how-to-add-a-custom-fraud-list","depth":2},{"value":"How to Delete a Custom Fraud List","id":"how-to-delete-a-custom-fraud-list","depth":2},{"value":"How to Add a Value to a Fraud List From the Charge View","id":"how-to-add-a-value-to-a-fraud-list-from-the-charge-view","depth":2},{"value":"How to Add a Value to the Fraud List From the Customer View","id":"how-to-add-a-value-to-the-fraud-list-from-the-customer-view","depth":2}],"frontmatter":{"title":"Lists","description":"Group values used for fraud protection into Fraud Lists so a single Fraud Rule can apply to all of them.","x-legacy-feature-gate":["!blacklist"],"seo":{"title":"Lists"}},"lastModified":"2026-09-11T07:43:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/fraud-prevention/lists","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}