Skip to main content

Greip Dashboard – Managing Blacklists

Blacklists allow you to block specific IP addresses, emails, email domains, customer IDs, customer IP addresses, card BINs, or card countries. This guide provides an overview of the blacklist feature, its benefits, and how to create and manage blacklists in Greip.

​
Adding a blacklist

To add a new blacklist, follow these steps:
1

First Step

Go to the Blacklists page from the account dashboard.
2

Second Step

Click on the ‘Add new’ button from the top right corner of the page to create a new blacklist.
3

Third Step

Give it a title that describes the list. This will help you identify the rule later.
4

Fourth Step

Choose the type of blacklist you want to create.
5

Fifth Step

Click the “Add blacklist” button to save the new blacklist.
6

Sixth Step

Click on the name of the the blacklist you just created to add values to it (e.g: IP addresses, emails, etc.).
Once you have added values to a blacklist, it will be considered immediately when you use the API.

​
Sample response with a blacklist detection

When the speicified value is found in one of your blacklists, the API will set the blacklisted property to true in the response. Here is a sample response: 
{
  "data": {
    "blacklisted": true
    // ...
  }
}

​
Definitions of blacklist types

The following are the types of blacklists you can create in Greip:
This type can be used to blacklist IP addresses and takes effect in the following endpoints:
  • IP Geolocation
  • IP Lookup
  • Bulk IP Lookup
  • IP Reputation
  • Payment Fraud Detection
Sample value: 1.1.1.1
This type can be used to blacklist email addresses and takes effect in the following endpoints:
  • Email Scoring
  • Payment Fraud Detection
Sample value: name@domain.com
This type can be used to blacklist email domains and takes effect in the following endpoints:
  • Email Scoring
  • Payment Fraud Detection
Sample value: domain.com
This type can be used to blacklist phone numbers and takes effect in the following endpoints:
  • Phone Scoring
  • Payment Fraud Detection
Sample value: 1234567890
The phone number should not have a + sign or zero at the beginning. And make sure to include the country dial code.
This type can be used to blacklist customer IDs and takes effect in the following endpoints:
  • Payment Fraud Detection
This type can be used to blacklist card BINs and takes effect in the following endpoints:
  • BIN Lookup
  • Payment Fraud Detection
Sample value: 456789
This type can be used to blacklist card countries and takes effect in the following endpoints:
  • BIN Lookup
  • Payment Fraud Detection
Sample value: US