{"id":2297,"date":"2026-04-19T08:14:00","date_gmt":"2026-04-19T02:44:00","guid":{"rendered":"https:\/\/www.smsgatewaycenter.com\/blog\/?post_type=docs&p=2297"},"modified":"2026-04-19T08:14:00","modified_gmt":"2026-04-19T02:44:00","password":"","slug":"what-is-ncpr_fail","status":"publish","type":"docs","link":"https:\/\/www.smsgatewaycenter.com\/blog\/kb\/what-is-ncpr_fail\/","title":{"rendered":"What is NCPR_FAIL?"},"content":{"rendered":"\n

NCPR_FAIL<\/strong> is a status used in SMSGatewayCenter to classify SMS delivery failures that are due to NCPR (National Customer Preference Register)<\/strong> 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\u2019s DND (Do Not Disturb) \/ NCPR rules.<\/p>\n\n\n\n

\n\n\n\n

In simple terms<\/h2>\n\n\n\n
    \n
  • NCPR<\/strong>\u00a0= 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.<\/li>\n\n\n\n
  • NCPR_FAIL<\/strong>\u00a0= \u201cFailure due to NCPR.\u201d The platform assigns this\u00a0status<\/strong>\u00a0to certain\u00a0global error codes<\/strong>\u00a0in 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\u00a0NCPR_FAIL<\/strong>.<\/li>\n<\/ul>\n\n\n\n

    So when you see NCPR_FAIL<\/strong> in reports, logs, or routing settings, it refers to SMS that failed because of NCPR\/DND<\/strong>, not because of other failures (e.g. invalid number, operator error).<\/p>\n\n\n\n

    \n\n\n\n

    Where you see NCPR_FAIL<\/h2>\n\n\n\n
      \n
    1. Global error codes<\/strong>
      In\u00a0Global Error Codes<\/strong>\u00a0(or equivalent), some error codes have\u00a0status = NCPR_FAIL<\/strong>. Those codes represent different NCPR-related failure reasons. The platform uses this status to:\n
        \n
      • Count\u00a0DND hits<\/strong>\u00a0(e.g. in A\/B Test Comparator, reports).<\/li>\n\n\n\n
      • Apply\u00a0NCPR Failed Message Routing<\/strong>\u00a0(retry failed NCPR messages on another route, if configured).<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • NCPR Failed Message Routing (User attributes)<\/strong>
        Admin can set\u00a0NCPR Failed Message Routing<\/strong>\u00a0(and related options like\u00a0NCPR Service Explicit Failed Message Routing<\/strong>,\u00a0NCPR Numeric Failed Message Routing<\/strong>) so that messages that failed with an NCPR_FAIL error code are sent to a different route for retry.<\/li>\n\n\n\n
      • Reports and analytics<\/strong>
        Where the product shows \u201cDND hits\u201d or \u201cNCPR failures,\u201d it is typically counting messages whose global error code has\u00a0status = NCPR_FAIL<\/strong>.<\/li>\n<\/ol>\n\n\n\n
        \n\n\n\n

        Why it matters<\/h2>\n\n\n\n
          \n
        • Compliance:<\/strong>\u00a0In 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.<\/li>\n\n\n\n
        • Routing:<\/strong>\u00a0You can use\u00a0NCPR Failed Message Routing<\/strong>\u00a0to retry NCPR-failed messages on another route (e.g. after NCPR data or checks are updated).<\/li>\n\n\n\n
        • Analysis:<\/strong>\u00a0DND hit counts and rates (e.g. in A\/B tests) help you clean lists and improve targeting so fewer messages hit DND.<\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n

          Related<\/h2>\n\n\n\n
            \n
          • Check DND Status<\/strong>\u00a0(user panel) uses NCPR data to let you verify if a number is on DND before sending.<\/li>\n\n\n\n
          • NCPR Enabled<\/strong>\u00a0(user) turns NCPR check on for that user\u2019s messages.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

            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\u2019s DND (Do Not Disturb) \/ NCPR rules. In simple terms So when […]<\/p>\n","protected":false},"author":118,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[1965],"doc_tag":[],"class_list":["post-2297","docs","type-docs","status-publish","hentry","doc_category-errors-error-codes"],"year_month":"2026-07","word_count":427,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"admin","author_nicename":"admin","author_url":"https:\/\/www.smsgatewaycenter.com\/blog\/author\/admin\/"},"doc_category_info":[{"term_name":"Errors & Error Codes","term_url":"https:\/\/www.smsgatewaycenter.com\/blog\/kb-cat\/errors-error-codes\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/docs\/2297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/users\/118"}],"replies":[{"embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/comments?post=2297"}],"version-history":[{"count":0,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/docs\/2297\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/media?parent=2297"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/doc_category?post=2297"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.smsgatewaycenter.com\/blog\/wp-json\/wp\/v2\/doc_tag?post=2297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}