# Blocklists

Use blocklists to prevent fraud and criminal activity. Blocklists are lists of customer attribute values that are blocked from buying from you. For example, if a customer attempts to make a purchase from you with a credit card or fingerprint that is in a blocklist, the transaction is blocked and will not be processed.

Before a new transaction is processed in Rebilly, blocklists are examined to check for attributes related to the entity. If a match is detected, the operation is aborted.

You can create blocklists based on [specific customer attributes](#create-a-blocklist) or automatically create blocklists based on specific events.

## Blocklist attributes

Rebilly provides the following blocklist attributes:

- Address: House number and ZIP code of the customer's address.
- BIN: The Bank Identification Number (BIN) of the payment card being charged.
- Country: Country where the customer is making the purchase, and of the payment card billing address.
- Customer ID: Rebilly `customerId` of the customer making the purchase.
- Device fingerprint: A string holding information about the software and the device used by the customer making the purchase.
- Email: Email address of the customer making the purchase.
- IP address: IP address of the customer making the purchase.
- Payment card: Payment card number being charged.


## Create a blocklist

This process describes how to blocklist customers based [attributes](#blocklist-attributes).

To automatically blocklist customers when specific events occur, see [Automated blocklists](#automated-blocklists).

1. In the left navigation bar, press .
2. In the **Risk** section, press **Blocklists**.
3. Press **Create blocklist**.
4. In the **Blocklist type** dropdown, select an [attributes](#blocklist-attributes) to blocklist.
5. Enter blocklist attribute information.
6. In the **TTL (Time to Live)** field:
  - To create a temporary entry, enter a value in seconds.
  - To create a permanent blocklist, enter `0` or leave this field blank.
7. Press **Save blocklist**.


## Block a customer

To manually block a customer from buying from you, see [Block a customer](/docs/data-tables/manage-customer-information#block-a-customer).

## View active blocklists

1. In the left navigation bar, press .
2. In the **Risk** section, press **Blocklists**.


## Automated blocklists

Use automated blocklists to automatically blocklist customers when specific events occur.

### Automated blocklist types

Rebilly provides the following automated blocklist types:

- Customer ID: Rebilly `customerId` of the customer making the purchase.
- Email: Email address of the customer making the purchase.
- Fingerprint: A string holding information about the software and the device used by the customer making the purchase.
- IP address: IP address of the customer making the purchase.
- Payment card: Payment card number being charged.


### Create an automated blocklist

This process describes how to create a blocklist that automatically blocks customers based on specific customer [attributes](#automated-blocklist-types) when a specific event occurs.

1. In the left navigation bar, press .
2. In the **Risk** section, press **Blocklists**.
3. In the top right of the page, press **Automated blocklists**.
4. Press **Create automated blocklists** or **Update automated blocklists**.
5. Select from the following:
  - Create predefined blocklistsSelect this option to create automated blocklists based on predefined events.
    1. In the **Predefined blocklists** section, select from the following:
      - **Dispute created:** Use this option to automatically blocklist customers when disputes are created. For example, when a customer disputes a transaction. 
To configure this option, turn on the **Dispute created** toggle.
      - **Transaction processed:** Use this option to automatically blocklist customers based on transaction results. For example, when fraud-related declines occur. 
To configure this option, turn on the **Transaction processed** toggle.
    2. In the **Type** dropdown, select an [attribute](#automated-blocklists) to blocklist.
    3. In the **TTL (Time to Live)** field:
      - To create a temporary entry, enter a value in seconds.
      - To create a permanent blocklist, enter `0` or leave this field blank. \
    4. To add multiple blocklist types, press **+ Add type**.
    5. Press **Save automated blocklist**.
  - Create custom blocklistsSelect this option to create automated blocklists with names that help you identify the automation in the list of automations, and conditions that specify when to trigger the blocklist.
    1. In the **Custom blocklist** section, press **Add custom blocklist**.
    2. In the **Name** field, enter a unique name for the blocklist.
    3. In the **Event** dropdown, select an event that triggers the blocklist.
      - To automatically blocklist customers when disputes are created, select the **Dispute created** event.
      - To automatically blocklist customer based on transaction results, select the **Transaction processed** event.
    4. Specify conditions that determine when the event triggers the automation: Clear the **No conditions** checkbox and specify a filter condition. To add multiple conditions, press **+ Add filter**. All filter conditions must be true for the automation to trigger.
    5. In the **Blocklist type** dropdown, select an [attribute](#automated-blocklists) to blocklist.
    6. In the **TTL (Time to Live)** field:
      - To create a temporary entry, enter a value in seconds.
      - To create a permanent blocklist, enter `0` or leave this field blank. \
    7. To add multiple blocklist types, press **+ Add type**.
    8. Optionally, to add multiple custom blocklists, press **Add another custom blocklist**.
    9. Press **Save automated blocklist**.


### Manage automated blocklists

This process describes how to edit, activate, deactivate, and delete automated blocklists. To manually add customer data to a blocklist, see [Add customer data to a blocklist](/docs/data-tables/manage-customer-compliance#add-customer-data-to-a-blocklist).

1. In the left navigation bar, press .
2. In the **Risk** section, press **Blocklists**.
3. In the top right of the page, press **Automated blocklists**.
4. Select from the following:
  - Edit automated blocklists    1. In the top right of the page, press **Update automated blocklist**.
    2. Make your changes.
    3. Press **Save automated blocklist**.
  - Activate or deactivate automated blocklists    1. In the **Automated blocklists** table, locate the automated blocklist you want to activate or deactivate.
    2. In the **Status** column, turn the toggle on or off.
  - Delete automated blocklists    1. In the **Automated blocklists** table, locate the automated blocklist you want to delete.
    2. On the right of the automated blocklist, press .