# 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 is not 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 types

Rebilly provides the following blocklist types:

- 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 on specific attributes.
For more information, see [blocklist types](#blocklist-types).

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

1. In the left navigation bar, press **Automations**.
2. In the **Risk** section, press **Blocklists**.
3. Press **Create blocklist**.
4. Enter the blocklist details.
5. In the **Type** dropdown, select a [blocklist type](#blocklist-types).
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**.


## Delete a blocklist

Use this process to delete an active blocklist.

1. In the left navigation bar, press **Automations**.
2. In the **Risk** section, press **Blocklists**.
3. In the top of the table, select a blocklist type.
4. Locate the blocklist you want to delete, then on the right of the blocklist, press **Delete**.


## 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

Use this process to view active blocklists.

1. In the left navigation bar, press **Automations**.
2. In the **Risk** section, press **Blocklists**.
3. In the top of the table, select a blocklist type.
4. Optionally, to filter blocklists:
  1. In the top left of the table, press **Filters**.
  2. In the **Filter** dropdown, select a filter.
  3. In the **Operation** dropdown, select a condition.
  4. In the **Value** field, enter or select values.
  5. Press **Apply filter**.
5. Optionally, to edit columns:
  1. In the top left of the table, press **Edit columns**.
  2. Select the columns you want to display.
  3. Press **Apply**.


## 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 **Automations**.
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:
Select 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-blocklist-types) 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**.

Select 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 customers 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-blocklist-types) 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 **Automations**.
2. In the **Risk** section, press **Blocklists**.
3. In the top right of the page, press **Automated blocklists**.
4. Select from the following:
  1. In the top right of the page, press **Update automated blocklist**.
  2. Make your changes.
  3. Press **Save automated blocklist**.

  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.

  1. In the **Automated blocklists** table, locate the automated blocklist you want to delete.
  2. On the right of the automated blocklist, press **Delete**.


## Inspect a blocklisted customer transaction

Use this process to find out why a specific customer transaction was blocklisted.
When a customer transaction matches a blocklist entry, the transaction is canceled and the details are recorded in the transaction timeline.

To exclude specific customer attribute values from blocklists, see [Allowlists](/docs/automations/allowlists).

1. [Log in or sign up](https://app-sandbox.rebilly.com/) to Rebilly.
2. In the left navigation bar, press **Data tables**, then press **Customers**.
3. Locate the customer, then in the **Name** column, press the customer's name.
4. Select one of the following:
  1. In the **Timeline** section, locate the canceled transaction event.
  2. To confirm that the transaction was canceled due to a blocklist match, on the right of the transaction, press **Caret right**.
Transactions that are canceled due to blocklist matches contain the following details:
    - In the **Message** field, **Rebilly blocklist match** is displayed.
    - In the **Original message** field, **Canceled due to blocklist match** is displayed.
  3. At the top of the event, press **Transaction**.

  1. Press **Segments**, then press **Payments**.
  2. Locate the canceled transaction, then in the **ID** column, press the transaction ID.
5. Press **Timeline**, and locate the **Transaction canceled due to blocklist match** event.
6. On the right of the event, press **Caret right**. 
Blocklist match details such as the blocklist type, source, expiration time, and creation time are displayed. 
For more information, see [blocklist types](#blocklist-types).