Usage Credit

Give usage credits to your clients in cloud marketplaces

Overview

The 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 + usaged-based combined, which has commit amount to consume. To eliminate confusion, they are ordered by their billing priorities in the table below. The Suger Credit is consumed first, then Commit, and the Included Quantity is the last.

Add Credit

There are two approaches to add credit to the Entitlement: Suger Console or Suger API.

1. Suger Console

Go to the page of Entitlement where you want to add the credit, and scroll down to the section of Entitlement Terms. Click the button Add credit, select the target Entitlement Term (optional), input the credit amount in the dialog and submit.

2. Suger 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.
}