--- updatedAt: 2026-07-01T17:24:34.000Z agentTools: siteIndex: https://docs.recurly.com/llms.txt projectIndex: https://docs.recurly.com/recurly-revrec/llms.txt --- # On-account credit Learn how on-account credits work in Recurly RevRec — how they're issued when subscriptions are canceled, redeemed, voided, and tracked in revenue recognition reports using plan codes.
On-account credit is a balance credited to a customer's account instead of a direct refund — typically when a subscription is canceled and the customer is eligible for a refund. The credit can be applied toward future purchases and flows directly into Recurly RevRec reports for accurate financial tracking.
Available as part of Recurly RevRec
1Definition 2Key benefits 3Key details 4FAQ
Additional costTo access this feature, you must have an active subscription to either Recurly RevRec or the Standard edition. Contact your Recurly account manager or support@recurly.com for pricing details.
### Prerequisites ### Limitations # Definition
On-account credit in Recurly refers to a balance credited to a customer's account instead of a direct refund. This occurs when a customer cancels a subscription and is eligible for a refund — rather than returning the money to the original source, Recurly credits the account, which can then be applied toward future purchases. These credits are accurately reflected in Recurly RevRec reports.
# Key benefits
Streamlined revenue recognition Incorporating on-account credits into revenue reports enhances financial accuracy by reflecting real-time customer balances and potential sales.
Enhanced financial reporting On-account credits contribute to a more comprehensive view of financial health, enabling precise revenue tracking and forecasting.
Increased operational efficiency Automated management of on-account credits simplifies reconciliation and ensures credits are accurately reflected in financial statements.
# Key details When a customer's subscription is canceled and a refund is due, Recurly can credit the account instead of issuing a direct refund. That on-account credit can then be used for any purchases within Recurly's platform. Upon issuing an on-account credit, Recurly generates a credit invoice reflecting the credited amount and any subsequent redemptions. The invoice updates to show the remaining balance over time, providing transparency for both the customer and your business. Credits and their redemptions are recorded in RevRec as distinct entries, categorized by origin (`credit-event`) and identified by unique plan codes for easy reconciliation.
OriginActivityPlan code
credit-eventOn-account credit issuedcredit-on-account
credit-eventOn-account credit redeemedcredit-on-account-redeemed
credit-eventOn-account credit voidedcredit-voided
credit-eventOn-account credit refundedcredit-paid
# FAQ When an on-account credit is issued, Recurly creates a credit invoice showing the initial credit amount. As the credit is redeemed, the invoice reflects the remaining balance over time. Filter by origin = credit-event and use these plan codes to identify each activity: - **Credit issued:** `credit-on-account` - **Credit used/redeemed:** `credit-on-account-redeemed` - **Credit canceled/voided:** `credit-voided` - **Credit refunded (paid out as cash):** `credit-paid`
# Sibling pages * [Goodwill credit](https://docs.recurly.com/recurly-revrec/docs/goodwill-credit.md) * [Prepayment credit](https://docs.recurly.com/recurly-revrec/docs/prepayment-credit.md)