This article explains how merchants can check whether a descriptor is active, pending, or unable to receive alerts in each alert network.
This article doesn't explain how to enroll a descriptor or how to fix account issues related to chargebacks that weren't prevented.
Before You Start
A billing descriptor can be active in one alert network and inactive in another. You must check the same descriptor in each alert network before you confirm that your account can receive alerts across all networks.
The enrollment dashboard shows descriptor status for each alert network.
The dashboard doesn't show statuses for additional coverage status for American Express and Discover. If you need a status update for additional coverage, contact Support.
How to Check Your Setup Status
If you want to check whether your descriptor can receive alerts, then follow these steps:
Go to Alerts in the sidebar.
From the dropdown, click Configure.
Open the Configure enrollments tab.
Select the alert network you want to review.
Find your billing descriptor(s).
Check the status shown beside the descriptor.
How to Search for Descriptors if I Have More Than One
If you have more than 1 billing descriptor and need to find them easier, go to the alert network you want to check the status under, then use one of these options.
1. Search for Descriptors
Click on the search bar and type the descriptor you want to search for. Or, you can use keywords (part of your descriptor), and the search results will pull up related descriptors.
2. Status Filter
To filter out active or inactive descriptors, click on the All Statuses box and select the status filter(s) you'd like to apply.
For example, if you want to find all descriptors that require further action, uncheck Active, Pending, Pending Unenroll, In Re-Enrollment, and In Progress.
How to Know Whether Your Descriptor is Active
If your descriptor shows Active, then that descriptor can receive chargeback prevention alerts for that alert network.
If your descriptor shows Pending, then that descriptor is still in the enrollment process and cannot receive alerts yet.
If your descriptor shows an error status, then that descriptor cannot receive alerts until the issue is resolved.
A descriptor status applies only to the alert network where it appears.
β
If Descriptor A is active and Descriptor B is not, then you only receive alerts for Descriptor A. If a descriptor is active in CDRN but inactive in Ethoca, then you only receive alerts through CDRN for that descriptor.
If Your Account is New
If your account is new, then the alert network card becomes active after your first descriptor becomes active in that network.
If you enrolled DESCRIPTOR A in CDRN, and that descriptor becomes active, then the CDRN network card shows as active.
This confirms that at least 1 descriptor in that alert network can receive alerts. It doesn't confirm that all descriptors in that alert network are active.
Troubleshooting Enrollment Issues
If your descriptors aren't active when they should have been, follow the troubleshooting steps below.
1. Account is in Demo Mode
If you see a Demo Mode indicator, then your account cannot receive chargeback prevention alerts yet.

To activate alerts, top up your balance until it is above the Minimum threshold.
If your balance is still below the Minimum threshold, then your enrollment stays inactive.
Further reading:
2. If Your Balance Dropped Below the Critical Threshold
If your account was active before, but your balance dropped below the Critical threshold, then your account may have been deactivated.
To reactivate alerts, top up your balance until it's above the Minimum threshold.
If your balance does not return above the Minimum threshold, then your account does not reactivate.
3. Descriptor Error Statuses
If your descriptor shows one of the statuses below, then the descriptor needs further action before it can become active:
Verification Needed
Enrolled Elsewhere
Generic Descriptor
Banned Descriptor
Invalid ARNs
Invalid Descriptor
Needs assistance
If you see one of these statuses, then review the message shown under the status and complete the required action.
If the dashboard message does not resolve the issue, then use the troubleshooting guide for that error or contact Support.
4. Descriptor Isn't Active When it Was Supposed to Be
If your descriptor does not show Active after the expected enrollment window, then contact Support.
Use these timeframes:
Ethoca or CDRN: contact Support if the descriptor is not active after 12 hours, excluding weekends
RDR: Contact Support if the descriptor is not active after 14 business days
American Express and Discover additional coverage: contact Support if the descriptor is not active after 4 weeks
Before you contact Support, check whether the descriptor shows an error status. If the descriptor shows an error status, resolve that issue first.
Further reading:
5. I'm Not Receiving Alerts After My Descriptor Went Active
If your descriptor shows Active, but chargebacks are still slipping through without alerts, then use the alert delivery troubleshooting guide.
6. Your Descriptor's Missing a Prefix
If your payment processor adds a prefix to your billing descriptor, then enrollment can take longer or fail if the prefixed version is missing.
A prefix is a set of characters that the payment processor automatically adds before the descriptor.
If your processor uses a prefix, then you must add both versions of the descriptor:
With prefix:
SP CHARGEBACK.IOWithout prefix:
CHARGEBACK.IO
If only one version is enrolled, then the descriptor may stay pending or fail to enroll.
Find your payment processor in one of these guides. Check whether your payment processor adds a prefix. If these guides don't include your payment processor, see this guide on descriptor optimization for additional prefixes.
π¬ Still need help? Contact Chargeback.io support.







