Usage Credit
Give usage credits to your clients in cloud marketplaces
Overview
ISV sellers can offer usage credits (in amount, default currency USD) to their clients (buyers) in the active Entitlements of all marketplaces. It provides flexibility for your sales or revenue operation team to customize deal & incentives.
Billing Priority
Credit is just one of multiple available incentives. For example, In Azure Marketplace, each metering metric can have included quantity or even infinite included quantity. In GCP Marketplace, the metric may have free tiered quantity. In addition, some Entitlements are type of commit + usage-based combined, which has commit amount to consume. To eliminate confusion, they are ordered by their billing priorities in the table below. The Fours Credit is consumed first, then Commit, and the Included Quantity is the last.
| Priority | Incentive | Description |
|---|---|---|
| 1st | Fours Credit | Applied first to incoming usage records, in the order they are received by the Fours metering API, until the credit amount is used up. |
| 2nd | Commit | Applicable if the Entitlement has commit amount (for AWS & GCP) or Flat_Rate (for Azure) |
| 3rd | Included Quantity |
|
Worked example
Assume a usage-based metric priced at $1/unit, on an entitlement with $30 Fours Credit, a $20 commit, and 10 units of Included Quantity. A usage record of 100 units ($100) is offset in priority order:
- Fours Credit (1st): $30 of the $100 is covered by credit. Remaining: $70.
- Commit (2nd): $20 of the remaining $70 is drawn from the commit amount. Remaining: $50.
- Included Quantity (3rd): 10 units (= $10) are covered by included quantity. Remaining: $40.
The buyer is billed the remaining $40. (Figures are illustrative.)
Add Credit
There are two approaches to add credit to the Entitlement: Fours Console or Fours API.
- Fours Console
Open the entitlement you want to credit. On its Overview tab, under Entitlement term (N), select the term in card view, or expand its row in table view, then click Add Credit at the right of the term’s Usage Dimensions (N) heading. The button appears only on an entitlement from AWS, Azure, GCP, Alibaba or Snowflake Marketplace, and only on a term that has usage dimensions. Divide Commit sits beside it (see Divide Entitlement Commit).
The Add Credit to Entitlement panel opens. As it says, usage is counted against the credit before it is billed as overage, and adding credit does not change the buyer’s payment schedule.
- Entitlement Term (optional): the panel does not pick the term you opened it from. Choose that term here, or leave it at None to add the credit to the entitlement’s default term.
- Credit Amount: the amount to add. The currency code beside the field is the entitlement’s currency, or USD when it has none.
Click Submit, then click Add credit in the confirmation that names the amount in that currency: Add a $500 credit?, for example, or Add a €1,500 credit? on a euro entitlement. Go back returns to the panel.
- Fours API
Use the addEntitlementCredit REST API to add the credit amount. The request payload would be like:
{
"organizationID": "your-suger-organization-id",
"entitlementID": "suger-entitlement-id",
"entitlementTermID": "suger-entitlement-term-id", // Optional
"creditAmountIncrement": 100.0,
}
The success response would be:
{
"organizationID": "your-suger-organization-id",
"entitlementID": "suger-entitlement-id",
"entitlementTermID": "suger-entitlement-term-id",
"creditAmountIncrement": 100.0,
"newCreditAmount": 150.0, // new total credit amount, assume there was $50.0 before addEntitlementCredit.
}
Credit added by the Chargebee usage sync
If Fours reports your Chargebee usage to the marketplaces, the sync can add credit to an entitlement term on its own. Marketplaces don’t accept negative usage, so an amount Fours has already reported can’t be pulled back — the sync credits it instead, in two cases:
- A discount lowers the invoice. When a Chargebee billing window closes and the metered line on its invoice, net of Chargebee discounts, comes to less than Fours already reported for that window, Fours adds the difference as credit.
- The invoice is voided. When a Chargebee invoice is voided after Fours reported its window, Fours credits the reported amount back to the entitlement that was billed.
This is the same credit you add yourself: it shows in the entitlement term’s Credit and Used Credit fields, it comes first in the billing priority, and it can’t be decreased. So credit on an entitlement term that nobody on your team added can come from this sync. Don’t also add credit by hand for the same Chargebee discount or voided invoice, or the buyer is credited twice. For how Fours settles each billing window, see How Fours settles each billing window.
Spotted something wrong or out of date on this page? Tell us and we'll correct it.