New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now

Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model context protocol)

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Invoices, Credit Notes and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Reason Codes
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Reason Codes

My custom reason codes are not showing up during the subscription cancellation process

Problem Statement

You have enabled reason codes but they do not display in the portal, or you are unsure why "Customers must mandatorily choose a reason for cancellation" is disabled under Portal settings.

Solution

If you have enabled reason codes in Settings > Configure Chargebee > Billing LogIQ and Settings > Configure Chargebee > Reason Codes, you must also enable them under Checkout & Self-Serve Portal > Portal settings.

Reason codes can be managed for cancel subscriptions, void invoices, create a credit note, refund credit note, and resend order scenarios.

Configuration Steps

Step 1: Navigate to Settings > Configure Chargebee > Billing LogIQ and enable Reason Codes.

Enable Reason Codes checkbox in Billing LogIQ

Step 2: Navigate to Settings > Configure Chargebee > Reason Codes to enable, manage default reason codes, and create, manage, or delete custom reason codes.

Reason Codes configuration page
Reason code section with Mandatory, Add custom, and Enable/Disable options

Step 3: To display reason codes on the Portal, navigate to Settings > Configure Chargebee > Checkout & Self-Serve Portal > Portal.

Portal settings with Cancel subscription options
Choose cancellation reasons to display and mandatory reason options

After enabling Allow customers to cancel subscriptions, you can configure:

  1. Choose cancellation reasons to display — Add reason codes to show on the Portal.
  2. Customers must mandatorily choose a reason for cancellation — Enable at site-level if not already enabled.
  3. Allow customers to provide feedback during cancellation — Enable the text box for customer feedback.

Related Articles

I want to remove some of the reason codes.
Reason Codes Error "Sorry the url or the some of the parameters are not valid"

Was this article helpful?