Skip to main content

​
Overview

What is a BIN Blacklist?A BIN (Bank Identification Number) is the first few digits of a credit or debit card that identify the issuing bank. The BIN Blacklist feature lets you block specific BINs from being used for payments within your account.

Tenant-wide (Global)

Applies to all subscriptions across your tenant.

Custom List (Per Subscription)

Assign different BIN rules to specific subscriptions.
This helps prevent payments from certain banks or card types that you don’t want to accept (e.g., prepaid cards, high-risk issuers).

​
How the BIN Blacklist works

Important: When a custom BIN list is assigned to a subscription, that subscription ignores the tenant-wide list. The custom list becomes the only active blacklist for that subscription.
Example
Your global list blocks 400000.
  • Subscription A uses the global list → transactions with 400000 are blocked.
  • Subscription B has a custom list that doesn’t include 400000 → transactions with 400000 are allowed for that subscription.

​
Managing your Global BIN List

The Global BIN List applies to your entire account unless a subscription uses a custom list.

​
View your global list

1

Navigate to Global BIN Blacklist

Go to Tools → Bin Blacklists → Global.
2

Review entries

You’ll see a table of all blocked BINs with details and reasons.

​
Add BINs to the global list

1

Start a new entry

Click Blacklist a BIN.
2

Enter BINs

Enter the BIN number (first 4–10 digits of the card). You can add multiple by separating with commas.
3

Describe the reason

Add a short description explaining why it’s blocked.
4

Create

Click Create to save.

​
Edit or remove BINs (global list)

1

Edit a BIN

Click the edit icon on the entry, update the reason, then Save.
2

Remove a BIN

Open the BIN’s details and click the delete button.

​
Managing Custom BIN Lists

Custom BIN lists let you define separate BIN rules for specific subscriptions.

​
Create a custom BIN list

1

Open Custom BIN Lists

Go to Billing → Custom BIN Lists.
2

Add a new list

Click Add new Blacklist.
3

Name your list

Enter a clear name (e.g., EU Cards Only), then click Create.

​
Add BINs to a custom list

1

Open your list

Select the list you created.
2

Add BIN entries

Click Blacklist a BIN, enter the BIN number and an optional reason.
3

Save

Click Save.

​
Edit, remove BINs, or delete a list

1

Update a BIN

View the BIN details and use the update button to edit.
2

Delete a BIN

Use the delete button within the BIN details.
3

Delete an entire list

In Custom BIN Lists, click the delete button on the list.
You cannot delete a list that is currently assigned to a subscription.

​
Assigning a Custom List to a Subscription

Assigning a custom list overrides the tenant/global BIN list for that subscription.
1

Open the subscription

Go to Subscriptions and select the subscription you want to update.
2

Open Additional Settings

In the side panel, locate Additional Settings and find the field Bin Blacklist.
3

Choose a list

Choose the desired custom list from the dropdown.
4

Save changes

Click Update subscription.
To revert back to the global list, open the same panel and choose Clear Selections.

​
Best Practices

Use Global for Always-on Rules

Company-wide restrictions that should always apply belong in the global list.

Use Custom for Specific Needs

Create custom lists for subscriptions with unique rules (e.g., currency, region, risk).
  • Keep BIN details clear — always include a short reason when blocking a BIN.
  • Review periodically — outdated BIN blocks can affect legitimate transactions.
  • Avoid duplication — if you copy a global BIN into a custom list, keep track to avoid confusion.

​
FAQs

No. Once a subscription is assigned a custom list, only that list applies.
As many as you need. There’s no limit per tenant.
Remove it from the list and save. The change takes effect immediately.

​
Troubleshooting

​
Summary

​
Need help?

Contact support with your tenant ID and the name of the BIN list if you experience issues.