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. Invoices, Credit Notes, and Quotes
  3. Articles and FAQ
  4. Credit Notes
  1. Billing
  2. Invoices, Credit Notes, and Quotes
  3. Articles and FAQ
  4. Credit Notes

Why isn't the promotional credits applying to my customer's invoice?

Problem Statement

You want to understand why isn’t the promotional credits applying to my customer’s invoice.

Scope

Do promotional credits apply to one-time charges?

When do promotional credits apply to metered-based billing?

Summary

Promotional Credits can be applied to all upcoming invoices, both "recurring" and "one-time" charges. However, there are two reasons why promotional credits do not apply to an invoice and they are

  1. Meter billing invoice in Pending state - Close the invoice and apply promotional credits

  2. Different Currency: Change the currency of the promotional credits respectively

If the customer already has a Payment Due/Not Paid Invoice, you cannot directly apply the promotional Credits to the existing Invoices. Hence you can either "Record payment" and Deduct the promotional credits or Void & Regenerate the invoice if it's within the term.

Solution

1. When you have configured usage-based billing (or) metered billing for your customers

If you would like to add promotional credits on the metered invoices, you have to close the invoice from the Pending state, which will automatically apply for credits if it's in the same currency.

In this case, the credits get applied only when the invoice gets closed.

2. When the customer charged currency differs from the currency of the promotional credits

      Change the currency of the promotional credits to match the invoice currency

For example, If an upcoming invoice that is due for a customer is in HK dollars and the promotional credits are in USD.

3. When the promotional credits are not applied to existing invoices or recent invoices.

There are two ways to overcome these circumstances.

i) When a customer has promotional credits, it is automatically applied whenever a new invoice is created. However, if the customer already has a Payment Due/Not Paid Invoice, you cannot directly apply the promotional Credits to the existing Invoices.

Step 1: Use the 'Record payment' option on the invoice and record an Offline Payment.

image
image

Step 2: Once done, go to the Promotional Credits section on the Customer details page > Promotional Credits (on the action panel) > choose 'Deduct Promotional Credits' > enter an amount equivalent to the offline payment that was recorded on the Invoice.

image

ii)Follow these steps to deploy the promotional credits:

a) If the invoice is within the billing term

Step 1: Void and Rengerate the existing invoice

                                                     (OR)

b) If the invoice is out of the billing term.

Step 1: Void the existing invoice and create an invoice with the same currency as that of the promotional credits

Step 2: Record payment (offline) against the existing due invoice and deduct the same from the promotional credits

Related Articles

Can one credit note be applied to two invoices?‌
How can I add or deduct promotional credits for customers?
Why the Total subscription MRR of the company is not updated or incorrect in Hubspot?
Prorated credits are not getting applied to imported subscriptions. What's causing this?
How can I refund the refundable credits available for a customer?
How to create a credit note?
I'm cancelling a subscription, how can I ensure that the unfulfilled orders alone are refunded?
How to delete a credit note?
What are the actions that can be performed on a refundable credit note?
How do I revert back offline refund to an online refund?

Show more

Was this article helpful?