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 or automatically create blocklists based on specific events.

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.

This process describes how to blocklist customers based on specific attributes. For more information, see blocklist types.

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

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.

To manually block a customer from buying from you, see Block a customer.

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.

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

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.

This process describes how to create a blocklist that automatically blocks customers based on specific customer attributes 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:

   Create predefined blocklists

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

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

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.

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:

   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 Delete.

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.

1. Log in or sign up 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:

   Locate the transaction using the timeline

   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 .

      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.

   Locate the transaction using segments

   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 .
   Blocklist match details such as the blocklist type, source, expiration time, and creation time are displayed.
   For more information, see blocklist types.