# Blacklist Page

### **Overview**

* Shows a table of blacklisted identifiers with: **Phone/Email**, **Reports**, **Last Seen**, **Source**, and **Status** (Blocked/Allowed).
* The **top-right switch** toggles the Blacklist feature **Active/Inactive** for your plan.
* Actions include: **Import**, **Add Customers**, **Settings**, **Search**, **Pagination**, and **per-row Allow/Block** controls.

### **Import Customers**

* Click **Import** to add customers in bulk.
* Upload **CSV/XLSX** or paste rows in the format: `phone,email`.
* Accepts phone-only, email-only, or phone+email pairs.
* Preview shows parsed entries. Click **Add customers** to save.
* Pairs automatically link phones to known emails for easier review.

### **Add Customers Manually (from your Shopify Store)**

* Click **Add Customers**.
* Search through your **existing Shopify customers** by name, email, or phone.
* Select one or more customers to add directly into your blacklist.
* Their phone/email identifiers will be added automatically.

This is useful for:

* Customers who abused COD
* Repeat fake-order customers
* Customers identified by support or fulfillment teams

### **Search & Browse**

* Use the **search bar** to filter by phone or email.
* **Pagination** and **rows per page** help manage large lists.
* Click a phone to open details:
  * View primary and additional emails
  * Double-click an email to set it as primary
  * Clear non-primary entries
  * Toggle Allowed/Blocked inline for each email

### **Allowed Overrides**

* Click a row’s status to toggle **Blocked ↔ Allowed**.
* **Allowed** works as a whitelist override — the payment method stays visible even if the customer appears in your blacklist or has reports.

### **Settings**

* **Payment method name to hide:** Enter the exact label shown at checkout (e.g., *Cash on Delivery (COD)*).
* **Threshold:** Choose how many reports trigger the hide action (1–5).
* **Signals:**
  * Use phone reports
  * Use email reports\
    At least one must remain enabled.
* Click **Save** to apply changes immediately.

### **Status & Badges**

* **Active/Inactive** badge reflects the main blacklist toggle.
* **Source** can be:
  * Imported (CSV/XLSX)
  * Manually added
  * Selected from Shopify customer list
* **Allowed/Blocked** shows the override state for each identifier.

### **What Happens At Checkout**

* When a shopper matches your blacklist and conditions are met, the App hides your configured payment method during checkout.
* **Allowed overrides** keep the payment method visible for customers you whitelist.

### **Quick Start**

1. Add customers (via CSV/XLSX, paste, or manual Shopify selection).
2. Open **Settings** — configure payment method name, threshold, and signals.
3. Turn the **Blacklist switch ON**.
4. Test checkout with a blacklisted customer.
5. Adjust overrides if needed.