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

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • 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)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

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

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

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
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • 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

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

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
  • Ecommerce Management
  • 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. Taxes
  3. Articles and FAQ
  4. Taxes
  1. Billing
  2. Taxes
  3. Articles and FAQ
  4. Taxes

How to setup Tax amount withheld for TDS?

Problem Statement

This article explains how to enable and use the Tax Amount Withheld (TAW) / TDS feature in Chargebee for recording tax withheld by customers on invoices (offline payments).

Related Scenarios

  • How to configure Tax Amount Withheld?
  • How to record TAW (Tax amount withheld) for TDS?
  • Can tax withheld be recorded for online payments?
  • What happens when tax withheld is removed from an invoice?

Solution

To record tax amount withheld for TDS in Chargebee, you must enable the setting for your site (via Support), then you can record withheld amounts on payment-due or not-paid invoices. Tax withheld is supported only for offline payments. When the setting is disabled, you cannot add tax withheld to any invoice (existing or new); you can remove an existing tax-withheld line but cannot add it back.

Note

Contact Support to enable this option for your site.

Steps to Set It Up

Enable the setting

  1. Go to Settings > Configure Chargebee > Taxes.
  2. Enable Record Tax Amount Withheld by Customers for offline payments.
  3. Click Save.
image

Record tax amount withheld on an invoice

  1. Open Customers or Subscriptions and select the customer or subscription.
  2. Open the associated Payment Due or Not Paid invoice.
  3. Click the ellipsis icon and enter the withheld amount (equal to or less than the amount due).
    image
  4. Optionally edit the note that appears for the withheld amount on the invoice PDF.
    image
  5. Click Proceed. The invoice PDF will show the tax withheld note.
    image
  6. You cannot edit the tax amount withheld after recording; you can remove it and add it again if needed.
    image

Additional Information

Issuing Credit Notes on Invoices with Taxes Withheld: When creating refundable credit notes or refunds for an invoice with tax withheld, the credit amount cannot exceed the sum of invoice amount, taxes withheld, and credits from previous credit notes.

Note

Limitations: (1) An invoice can have only one Tax Withheld line at a time. (2) Tax withheld can be recorded only for offline payments, not online. (3) Recording tax amount withheld is not supported on sites with the Orders module enabled. (4) When the Tax Withheld line is removed, the total amount due increases; the withheld amount is not added to excess payment.

Related Articles

When an invoice is generated and paid via account credits, the tax is not added. Why?
What is Tax Amount Withheld or Tax Deducted as Source (TDS)
Which address is considered for Tax calculation in Chargebee?

Was this article helpful?