Goodwill credit
Learn how Goodwill credits work in Recurly RevRec — how they're issued, redeemed, voided, and tracked in revenue recognition reports using plan codes.
Prerequisites
- A cancellation and refund policy that supports account crediting.
Limitations
- Goodwill credits are non-transferable and must be used within the issuing account.
- Credits may have expiration dates or usage conditions, depending on your business policy.
Definition
Key benefits
Key details
When goodwill credit is allocated, Recurly generates a credit invoice reflecting the credit balance, which can be adjusted against subsequent payments. Credits are recorded as a single line in revenue recognition reports, with redemptions detailed separately — giving you a clear picture of credit usage and its impact on financial health.

The following table outlines the identifiers for goodwill credit transactions:
| Origin | Activity | Plan code |
| credit-event | Goodwill issued | credit-goodwill |
| credit-event | Goodwill redeemed | credit-goodwill-redeemed |
| credit-event | Goodwill voided | credit-goodwill-voided |

If goodwill credit is issued erroneously or remains unused, it can be voided — removing the balance from the customer's account. This action, along with all other credit transactions, is recorded in RevRec for comprehensive financial oversight.

FAQ
How are Goodwill Credits and their usage tracked in RevRec?
Goodwill credits appear as distinct lines identified by plan code:
- Credit issued:
credit-goodwill - Credit used/redeemed:
credit-goodwill-redeemed - Credit canceled/voided:
credit-goodwill-voided
Credit-related lines also show origin = credit-event.
What happens if a Goodwill Credit is given by mistake or is never used?
Void the credit. A voided credit is no longer available to the customer, and RevRec records a reversal line with plan code credit-goodwill-voided.