Introduction
APIs
- Authentication
- Customers
- Accounts
- Aliases
- Event Schemas
- Usage Meters
- AddOns
- Licenses
- Feature
- (Deprecated) Price Plans
- Price Plan V2
- GETList price plans
- POSTCreate a price plan
- GETGet a price plan
- PATCHUpdate a price plan
- DELDiscard a price plan
- POSTFinalize a price plan
- GETList rate cards of a price plan
- POSTBulk rate card operations of a price plan
- GETList pricing rules of a price plan
- PUTUpdate pricing rules of a price plan
- GETGet list of errors of a price plan
- GETList price plan versions
- POSTCreate a price plan v2 migration
- GET
- Settings
- Price Experimentation
- Jobs
- Event Ingestion
- Entitlements
- Event Management
- Metrics
- Credits
- Invoices
- Payments
- Wallet
- InvoiceGroups
- Alerts
- Reports
Bulk rate card operations of a price plan
Bulk rate card operations of a price plan
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
50
Body
Bulk rate card operations for price plan
Operation type
CREATE
, UPDATE
, DELETE
Required for UPDATE and DELETE operations
50
Request to create a rate card
Billable identifier
50
Rate card type
MINIMUM_COMMITMENT
, BILLING_ENTITLEMENT
, CREDIT_GRANT
, ENTITLEMENT_OVERAGE
, FIXED_FEE
, LICENSE
, USAGE
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Rate card details
Unique Identifier of the attached AddOn
50
Name of the attached AddOn
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group fixedFeeRateCards
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Fixed fee applies either for a one-time occurrence or for each cycle.
ONE_TIME
, RECURRING
Billing Entitlement rate card
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Contains all rate related configurations
A tag string to group rate cards
Name your rate card, this will be used in invoice
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
Credit grant rate card
Grant details of Credit Grant Rate Card
Amount to be credited
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group creditGrantRateCard
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Credit grant applies either for a one-time occurrence or for each cycle.
ONE_TIME
, RECURRING
Contains all rate related configurations
Name your rate card, this will be displayed in the Togai App
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group usageRateCards
Unique Identifier of the attached AddOn
50
Contains all rate related configurations
LICENSE: Addon can be used in license rate cards FIXED_FEE: Addon can be used in fixed fee rate cards CREDIT_GRANT: Addon can be used in credit grant rate cards NAMED_LICENSE: Addon can be used in license rate cards
LICENSE
, FIXED_FEE
, CREDIT_GRANT
, NAMED_LICENSE
Name of the attached AddOn
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group licenseRateCards
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
UsageCycleInterval field allows you to treat the billing interval as many smaller windows. Revenue is calculated for each of the windows (usage cycles) and their sum is considered as the billing interval revenue. Example: 1 Named License being used across entire billing interval. Rate Value: $1/license CASE 1: Without usage cycle. $1 is charged for the entire billing cycle. CASE 2: Usage cycle is configure to be WEEKLY and the billing interval has 4 weeks. In this case $1 is charged for each week totalling to $4 across for the billing interval
WEEKLY
, MONTHLY
, QUARTERLY
, HALF_YEARLY
, ANNUALLY
NONE
, CREDITS
, PAYMENT
, WALLET
Unique Identifier of the attached Feature
50
Contains all rate related configurations
Name to be displayed during invoice
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group rate cards
Maximum quantity allowed for the feature, if not specified, unlimited quantity is allowed
Represents the billing config of the entitlement overage rate card. If not specified interval:1 and startOffset:0 is taken as default value
Display name of the rate card
255
Tag for rate card
50
Response
Bulk rate card operations response
Billable identifier
50
Rate card type
MINIMUM_COMMITMENT
, BILLING_ENTITLEMENT
, CREDIT_GRANT
, ENTITLEMENT_OVERAGE
, FIXED_FEE
, LICENSE
, USAGE
Display name of the rate card
255
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Rate card details
Unique Identifier of the attached AddOn
50
Name of the attached AddOn
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group fixedFeeRateCards
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Fixed fee applies either for a one-time occurrence or for each cycle.
ONE_TIME
, RECURRING
Represents the number of pricing cycles after which the rate card will be charged
Represents the offset for pricing cycles after which the rate card will be charged
Billing Entitlement rate card
x > 0
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Contains all rate related configurations
Togai supports two type of pricing model Tiered and Volume. Tiered pricing model applies respective slab and its rate to the usage value while volume pricing model applies the latest matching slab of the usage value and applies respective rate. For more understanding read Rate Cards
TIERED
, VOLUME
Rate cards can have single or multiple slab up to 100.
A tag string to group rate cards
Name your rate card, this will be used in invoice
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
Represents the number of pricing cycles after which the rate card will be charged
Represents the offset for pricing cycles after which the rate card will be charged
Credit grant rate card
Grant details of Credit Grant Rate Card
x > 0
Expiry type of grant
PRICING_CYCLE
, NO_EXPIRY
, CUSTOM
Amount to be credited
Togai supports two type of pricing model Tiered and Volume. Tiered pricing model applies respective slab and its rate to the usage value while volume pricing model applies the latest matching slab of the usage value and applies respective rate. For more understanding read Rate Cards
TIERED
, VOLUME
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group creditGrantRateCard
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
Credit grant applies either for a one-time occurrence or for each cycle.
ONE_TIME
, RECURRING
Represents the number of pricing cycles after which the rate card will be charged
Represents the offset for pricing cycles after which the rate card will be charged
Contains all rate related configurations
Togai supports two type of pricing model Tiered and Volume. Tiered pricing model applies respective slab and its rate to the usage value while volume pricing model applies the latest matching slab of the usage value and applies respective rate. For more understanding read Rate Cards
TIERED
, VOLUME
Rate cards can have single or multiple slab up to 100.
Name your rate card, this will be displayed in the Togai App
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group usageRateCards
Unique Identifier of the attached AddOn
50
Contains all rate related configurations
Togai supports two type of pricing model Tiered and Volume. Tiered pricing model applies respective slab and its rate to the usage value while volume pricing model applies the latest matching slab of the usage value and applies respective rate. For more understanding read Rate Cards
TIERED
, VOLUME
Rate cards can have single or multiple slab up to 100.
LICENSE: Addon can be used in license rate cards FIXED_FEE: Addon can be used in fixed fee rate cards CREDIT_GRANT: Addon can be used in credit grant rate cards NAMED_LICENSE: Addon can be used in license rate cards
LICENSE
, FIXED_FEE
, CREDIT_GRANT
, NAMED_LICENSE
Name of the attached AddOn
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group licenseRateCards
If IN_ADVANCE, the rate card will be invoiced in the previous billing cycle. If IN_ARREARS, the rate card will be invoiced in the current billing cycle. If PREPAID, credits/entitlements will be granted only after invoice is paid
IN_ADVANCE
, IN_ARREARS
, PREPAID
UsageCycleInterval field allows you to treat the billing interval as many smaller windows. Revenue is calculated for each of the windows (usage cycles) and their sum is considered as the billing interval revenue. Example: 1 Named License being used across entire billing interval. Rate Value: $1/license CASE 1: Without usage cycle. $1 is charged for the entire billing cycle. CASE 2: Usage cycle is configure to be WEEKLY and the billing interval has 4 weeks. In this case $1 is charged for each week totalling to $4 across for the billing interval
WEEKLY
, MONTHLY
, QUARTERLY
, HALF_YEARLY
, ANNUALLY
Max allowed quantity for a particular license in a price plan
Action to be taken when the license maxQuantity is breached:
DO_NOTHING
: Refrain from granting any new licenses.
DO_NOTHING
NONE
, CREDITS
, PAYMENT
, WALLET
Unique Identifier of the attached Feature
50
Contains all rate related configurations
Togai supports two type of pricing model Tiered and Volume. Tiered pricing model applies respective slab and its rate to the usage value while volume pricing model applies the latest matching slab of the usage value and applies respective rate. For more understanding read Rate Cards
TIERED
, VOLUME
Rate cards can have single or multiple slab up to 100.
Name to be displayed during invoice
Unique identifier for the rate card in a price plan. If left null it is auto-generated.
A tag string to group rate cards
Maximum quantity allowed for the feature, if not specified, unlimited quantity is allowed
Represents the billing config of the entitlement overage rate card. If not specified interval:1 and startOffset:0 is taken as default value
Represents the number of pricing cycles after which the rate card will be billed
Represents the offset for pricing cycles after which the rate card will be billed
Tag for rate card
50
50
50
50
List of currencies supported by the rate card
Price plan identifier
50
Account identifier