> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paysight.io/llms.txt
> Use this file to discover all available pages before exploring further.

# BIN Blacklist Listing

> Complete guide for enabling and configuring BIN BLOCKING with Paysight

## Overview

<Info>
  **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.
</Info>

<CardGroup cols={2}>
  <Card title="Tenant-wide (Global)" icon="building">
    Applies to all subscriptions across your tenant.
  </Card>

  <Card title="Custom List (Per Subscription)" icon="list-check">
    Assign different BIN rules to specific subscriptions.
  </Card>
</CardGroup>

<Tip>
  This helps prevent payments from certain banks or card types that you don’t want to accept (e.g., prepaid cards, high-risk issuers).
</Tip>

## How the BIN Blacklist works

<Table>
  <thead>
    <tr>
      <th>Level</th>
      <th>Applies To</th>
      <th>Typical Use Case</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Tenant / Global List</td>
      <td>Every subscription under your account</td>
      <td>Block BINs for the entire business (e.g., block prepaid cards)</td>
    </tr>

    <tr>
      <td>Custom List</td>
      <td>Only the subscriptions it’s assigned to</td>
      <td>Different rules for different products or regions</td>
    </tr>
  </tbody>
</Table>

<Warning>
  **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.
</Warning>

<Note>
  **Example**

  <br />

  Your global list blocks <code>400000</code>.<br />

  * Subscription A uses the global list → transactions with <code>400000</code> are blocked.<br />
  * Subscription B has a custom list that doesn’t include <code>400000</code> → transactions with <code>400000</code> are allowed for that subscription.
</Note>

## Managing your Global BIN List

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

### View your global list

<Steps>
  <Step title="Navigate to Global BIN Blacklist">
    Go to <strong>Tools → Bin Blacklists → Global</strong>.
  </Step>

  <Step title="Review entries">
    You’ll see a table of all blocked BINs with details and reasons.
  </Step>
</Steps>

### Add BINs to the global list

<Steps>
  <Step title="Start a new entry">
    Click <strong>Blacklist a BIN</strong>.
  </Step>

  <Step title="Enter BINs">
    Enter the BIN number (first 4–10 digits of the card). You can add multiple by separating with commas.
  </Step>

  <Step title="Describe the reason">
    Add a short description explaining why it’s blocked.
  </Step>

  <Step title="Create">
    Click <strong>Create</strong> to save.
  </Step>
</Steps>

### Edit or remove BINs (global list)

<Steps>
  <Step title="Edit a BIN">
    Click the <strong>edit</strong> icon on the entry, update the reason, then <strong>Save</strong>.
  </Step>

  <Step title="Remove a BIN">
    Open the BIN’s details and click the <strong>delete</strong> button.
  </Step>
</Steps>

## Managing Custom BIN Lists

<Info>
  Custom BIN lists let you define separate BIN rules for specific subscriptions.
</Info>

### Create a custom BIN list

<Steps>
  <Step title="Open Custom BIN Lists">
    Go to <strong>Tools → Custom BIN Lists</strong>.
  </Step>

  <Step title="Add a new list">
    Click <strong>Add new Blacklist</strong>.
  </Step>

  <Step title="Name your list">
    Enter a clear name (e.g., <em>EU Cards Only</em>), then click <strong>Create</strong>.
  </Step>
</Steps>

### Add BINs to a custom list

<Steps>
  <Step title="Open your list">
    Select the list you created.
  </Step>

  <Step title="Add BIN entries">
    Click <strong>Blacklist a BIN</strong>, enter the BIN number and an optional reason.
  </Step>

  <Step title="Save">
    Click <strong>Save</strong>.
  </Step>
</Steps>

### Edit, remove BINs, or delete a list

<Steps>
  <Step title="Update a BIN">
    View the BIN details and use the <strong>update</strong> button to edit.
  </Step>

  <Step title="Delete a BIN">
    Use the <strong>delete</strong> button within the BIN details.
  </Step>

  <Step title="Delete an entire list">
    In <strong>Custom BIN Lists</strong>, click the <strong>delete</strong> button on the list.
  </Step>
</Steps>

<Warning>
  You cannot delete a list that is currently assigned to a subscription.
</Warning>

## Assigning a Custom List to a Subscription

<Callout type="info">
  Assigning a custom list overrides the tenant/global BIN list for that subscription.
</Callout>

<Steps>
  <Step title="Open the subscription">
    Go to <strong>Subscriptions</strong> and select the subscription you want to update.
  </Step>

  <Step title="Open Additional Settings">
    In the side panel, locate <strong>Additional Settings</strong> and find the field <strong>Bin Blacklist</strong>.
  </Step>

  <Step title="Choose a list">
    Choose the desired custom list from the dropdown.
  </Step>

  <Step title="Save changes">
    Click <strong>Update subscription</strong>.
  </Step>
</Steps>

<Tip>
  To revert back to the global list, open the same panel and choose <strong>Clear Selections</strong>.
</Tip>

## Best Practices

<CardGroup cols={2}>
  <Card title="Use Global for Always-on Rules" icon="shield">
    Company-wide restrictions that should always apply belong in the global list.
  </Card>

  <Card title="Use Custom for Specific Needs" icon="gears">
    Create custom lists for subscriptions with unique rules (e.g., currency, region, risk).
  </Card>
</CardGroup>

<Note>
  * 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.
</Note>

## FAQs

<AccordionGroup>
  <Accordion title="Can I have both global and custom BIN lists active for a subscription?" icon="circle-question">
    No. Once a subscription is assigned a custom list, only that list applies.
  </Accordion>

  <Accordion title="How many custom lists can I have?" icon="list">
    As many as you need. There’s no limit per tenant.
  </Accordion>

  <Accordion title="What if I accidentally block the wrong BIN?" icon="triangle-exclamation">
    Remove it from the list and save. The change takes effect immediately.
  </Accordion>
</AccordionGroup>