Getting Started

Building Blocks

Subscription Features



Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data


Open Source Resources

Other Features

API Integration

Third Party Integrations


When you refund a payment, you are essentially returning the funds received from a customer. Refunds may be partial (only a portion of the amount is refunded) or full (the entire amount is refunded).

There may be several reasons for refunding a subscription such as incorrect charge, cancellation, or unsatisfactory service.

In Chargebee, you can either issue a refund or record offline refunds. For both operations, Credit Notes will be generated for the refunds made.

Issuing a Refund 

You can issue a refund for paid or partially paid invoices through the web interface or using the API . To issue refund through the web interface, open the invoice that you want to refund and click the Refund button on the Actions panel:

A prompt asking you to confirm the refund appears, displaying details of the Credit Notes that will be created for the refund. Click Confirm.

A Refundable Credit Note with details of the refund made will be available in the Credit Notes page.

  • This option cannot be used to refund invoices that have been paid offline. You need to manually record such refunds in Chargebee.
  • Once you make the refund the amount will be credited to the account that was used for the payment.
  • If the refund is being made for a transaction that is not settled, then the transaction will simply be voided. Partial refunds are also not supported for transactions that are yet to be settled.
  • Refunds are taken into account as separate transactions, and transaction charges may be applied. However, when a transaction is voided, it is not considered as a separate transaction.
  • Refunds can only be made within a specific period of time from the date of the transaction. The period allowed for refund depends on the gateway that was used for the transaction.

Reconciling Offline Refunds 

To reconcile the refunds that you have made offline, record them in Chargebee using the Record Refund option:

record refund button

You can use this option to record refunds that have been made via payment methods other than card such as cash, check, bank transfer, and so on.
Click Record Refund to provide details of the refund, such as the amount, refund method, refund date, reference number. Provide comments and notes, if any.


You can also record offline refunds using the 'record a refund' API .

Partial and Full Refunds 

You can only refund up to the amount charged on the invoice. That is, you can make one or more partial refunds or a full refund against an invoice until you reach the total amount charged. Chargebee will not let you refund more than what is on the invoice.

When refunding an invoice that also includes Promotional Credits, the refund will proportionately return the funds to both the card used and the Promotional Credits balance.


Total Invoice Amount: $12
Promotional Credits Adjusted: $6
Card Payment: $6

If you're refunding say $6, $3 will be added back to the Promotional Credits balance and $3 will be returned back to the card used to make the payment.

Adding Credits Instead of a Refund 

If you want to provide credits to your customer instead of a refund, you could create Credit Notes. This is quite useful in situations where you do not have to refund money to a customer, but you can provide credits that can be applied to the next invoice.