A credit grant adds a defined amount of usable balance to a customer's wallet, such as bundled plan credits, a promotion, or a paid top-up. In Credyt, grants stack and draw down by priority, each with its own rules.
A credit grant is how balance gets into a customer's wallet. Every bit of usable balance arrives as a grant: the credits included in a plan, a promotional bonus, or a paid top-up. In Credyt, grants are first-class objects, each with its own amount, purpose, expiry, and priority, so the platform controls exactly how a customer's balance behaves.
How Credit grants works
When a customer gets balance, Credyt records it as a grant with attributes: the amount, the asset (tokens, credits, dollars), a purpose (bundled, promotional, paid), and optional expiry and rollover rules. A customer’s wallet can hold several grants at once.
When usage draws down the balance, Credyt consumes grants by priority rather than treating the balance as one undifferentiated pool. For example, promotional credits can be set to burn before paid credits, and expiring grants before non-expiring ones. This stacked-grant model means the platform decides the order in which a customer’s balance is spent.
Credit grants examples
A plan includes 1M tokens each month as a recurring bundled grant; a signup promotion adds a one-time 100k-token grant set to expire in 30 days; the customer later buys a 500k-token top-up as a paid grant. Credyt draws down the promotional grant first (it expires), then the bundled allowance, then the paid top-up.
This ordering protects the customer (expiring credits are used before they vanish) and the business (paid credits are preserved).
Credit grants vs Single balance
| Stacked credit grants | Single balance | |
|---|---|---|
| Structure | Multiple grants, each with rules | One undifferentiated pool |
| Drawdown | By priority (purpose, expiry) | First-in or undefined |
| Expiry / rollover | Per grant | All or nothing |
| Control | Fine-grained | Coarse |
Benefits & when to use it
Credit grants give a product precise control over how balance is granted and spent: bundled allowances that refresh each cycle, time-limited promotions, and paid top-ups can coexist in one wallet and draw down in a sensible order. This supports hybrid plans, trials, promotions, and prepaid top-ups without custom logic.
The model matters most for products with mixed balance sources, an included allowance plus promotions plus paid credits, where a single pooled balance would lose the distinctions that pricing and promotions depend on.
FAQ
What is a credit grant?
A defined amount of usable balance added to a customer's wallet, from a plan inclusion, a promotion, or a paid top-up. In Credyt each grant carries its own amount, purpose, expiry, and priority.
How do stacked credit grants draw down?
By priority rather than as one pool. Credyt consumes grants in a configured order, for example expiring promotional credits before bundled allowance before paid top-ups, so balance is spent in the way that best serves the customer and the business.
How do credit grants relate to entitlements?
An entitlement defines what a plan includes; a credit grant is how an included usage allowance is actually held and drawn down in the wallet. Entitlements set the rule; grants carry the balance.
How Credyt handles Credit grants
Credit grants are a core Credyt primitive. Grants are stacked in the wallet with per-grant purpose, expiry, rollover, and drawdown priority, and usage debits them in real time in the configured order. This lets products run bundled allowances, promotions, and paid top-ups together cleanly. See the platform. Explore Credyt →