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

How can I add or deduct promotional credits for customers?

Problem Statement

You need to add or deduct promotional credits for a customer. You can do this via the Admin Console or via APIs.

Solution

Via Admin Console

  1. Go to Subscriptions > Customers.
  2. Find the customer using the search option.
  3. Click the Customer ID to open the customer details page.
  4. Click Promotional Credits (on the right panel).
  5. Choose Deduct or Add.
  6. Select the currency type (if applicable).
  7. Enter the amount to add or deduct from the current balance.
  8. Enter a description (for example, to record the reason).
  9. Click Update to complete the action.
Promotional Credits panel on customer details page

Note

In Leap UI, even when adding new promotional credit, the UI shows Update Promotional Credit.

Add or Deduct promotional credit options
Promotional credit amount and description fields
Update Promotional Credit button

Via APIs

Use the Add/Deduct Promotional credits API. Chargebee APIs are supported on multiple language platforms.

Important Notes

  • Promotional credits are applied before tax, similar to discounts. Adjustment and Refundable Credits are handled like payments and are applied after tax.
  • Promotional credits are automatically applied to the next invoice when available.
  • Promotional credits are added at the customer level and apply to all subscriptions under that customer.

Related Articles

Can one credit note be applied to two invoices?‌

Was this article helpful?