NCPR_FAIL is a status used in SMSGatewayCenter to classify SMS delivery failures that are due to NCPR (National Customer Preference Register) checks. When a message is marked with an error code whose status is NCPR_FAIL, it means the message did not go through because of India’s DND (Do Not Disturb) / NCPR rules.
In simple terms #
- NCPR = National Customer Preference Register (India). It is the TRAI-regulated data that indicates which mobile numbers have opted for DND and their preferences for promotional/transactional messages.
- NCPR_FAIL = “Failure due to NCPR.” The platform assigns this status to certain global error codes in the system. When your SMS fails for an NCPR-related reason (e.g. number on DND, NCPR check failed, service explicit or numeric SID check failed), the message is logged with one of those error codes. Those codes are grouped under the status NCPR_FAIL.
So when you see NCPR_FAIL in reports, logs, or routing settings, it refers to SMS that failed because of NCPR/DND, not because of other failures (e.g. invalid number, operator error).
Where you see NCPR_FAIL #
- Global error codes
In Global Error Codes (or equivalent), some error codes have status = NCPR_FAIL. Those codes represent different NCPR-related failure reasons. The platform uses this status to:- Count DND hits (e.g. in A/B Test Comparator, reports).
- Apply NCPR Failed Message Routing (retry failed NCPR messages on another route, if configured).
- NCPR Failed Message Routing (User attributes)
Admin can set NCPR Failed Message Routing (and related options like NCPR Service Explicit Failed Message Routing, NCPR Numeric Failed Message Routing) so that messages that failed with an NCPR_FAIL error code are sent to a different route for retry. - Reports and analytics
Where the product shows “DND hits” or “NCPR failures,” it is typically counting messages whose global error code has status = NCPR_FAIL.
Why it matters #
- Compliance: In India, sending promotional SMS to numbers on DND can lead to complaints and penalties. NCPR_FAIL helps you see how many messages failed due to NCPR/DND.
- Routing: You can use NCPR Failed Message Routing to retry NCPR-failed messages on another route (e.g. after NCPR data or checks are updated).
- Analysis: DND hit counts and rates (e.g. in A/B tests) help you clean lists and improve targeting so fewer messages hit DND.
Related #
- Check DND Status (user panel) uses NCPR data to let you verify if a number is on DND before sending.
- NCPR Enabled (user) turns NCPR check on for that user’s messages.