When you create and configure Plan Templates and Plans for your Products to prepare for setting up usage-based pricing to charge Accounts that consume your Products, several key billing options are available. These billing options are designed to give you maximum flexibility in controlling the way you want to Bill your customer Accounts.
This topic explains in detail the key billing options available for Plan Templates/Plans.
You can select a billing currency at two levels:
Organization level. This defines the currency used for Bills created against Accounts across your Organization.
Individual Account level. You also can set the billing currency at level of an individual Account level and choose to override the Organization-level billing currency for the Account.
However, when you create Plan Templates you select a currency. Any Plan based on the template will inherit the currency setting and when you price the Plan, the pricing will use this currency.
Suppose you have end customer Accounts across many different countries. You might want to always price for product usage by each Account using the same single currency. However, you want generate the Bills for each Account in the currency specific to their geographical location. The charge amounts for each Account Bill that doesn't use the same currency as your preferred pricing currency will then have Bill amounts calculated using the currency conversion rates you maintain in your m3ter Organization.
If you attach a Plan to an Account and the Plan uses a currency that is different to the billing currency, when a Bill is generated for the Account the line items are first calculated using the Plan currency and then the line item amounts are converted to the selected billing currency:
Billing Currency is Organization-level or Account-level. This process occurs whether you are using the Organization-level billing currency or using an Account billing currency.
Currency Conversions. For this to work, you must first set up currency conversion rates which the billing process can use to convert the Plan currency amounts into the billing currency amounts. See Adding Currency Conversion Rates.
IMPORTANT! If you're using different currencies and you haven't defined a conversion rate in your Organization configuration for converting the Plan currency into the selected billing currency, then Bill creation will fail and you'll receive an error Alert.
Scheduled Billing. This means that for scheduled billing runs, Billing always uses the billing currency that you've selected either at Organization level or individual Account level.
You can do this by creating a Bill Job, where you can specify:
The Accounts for which you want their Bills created in a specific currency.
The currency the Bills will use.
Conversion rates for converting Plan currencies to Bill currency.
Conversion rates you've defined at Organization level can also be used. If a conversion rate is defined both at Organization level and for the Bill Job, the Bill Job rate is used.
You can use the Create a new Bill Job API call to do this. See the Bill Job section in our API Reference Docs for other calls you can use to create and manage Bill Jobs.
A Standing Charge allows you to set a fixed amount that is charged on a Bill:
You can define this fixed amount for Plan Templates, Plans, and Plan Groups.
When defined for a Plan Group, which doesn't have a well-defined billing cycle since the Plans it contains might have different billing dates or frequencies, then if any of the Plans in the Group should be included in the billing run, then the Plan Group Standing Charge amount is included.
If you don't want the Standing charge to be applied to every Bill in a series, you can use the settings for Standing charge interval and Standing charge offset to control which Bills in a series of Bills the Standing Charge is applied to:
A Standing charge interval of 3 means the charge is applied only to every 3rd Bill.
If you set the Standing charge interval to 3, you can then use the Standing charge offset to determine which of the Bills in a series the charge is applied to - is it to the 1st bill, 4th bill, 7th bill and so on? Or, is it the 2nd Bill, 5th Bill, 8th Bill, and so on? The offset is applied from the 1st bill, so an offset of 0 would mean it appears on the 1st Bill, 4th Bill, 7th Bill and so on; an offset of 1 would mean it appears on the 2nd Bill, 5th Bill, 8th Bill, and so on.
A Minimum Spend allows you to define a minimum amount that your customer has agreed to spend for usage charges on each Bill they receive.
Important! Minimum Spend excludes any charges due at billing for Standing Charges or Prepayment/Commitment fees.
You can define a Minimum Spend at three levels:
Plan Template or Plan
The way in which the Minimum Spend amount is assessed differs at the three levels:
Plan Template or Plan. All line item charges for usage of the Product are added up. If there is any shortfall against the Minimum Spend amount, this is added as a new line item to the Bill.
Plan Group. Line item charges for usage on all the Products for all the Plans in the Plan Group are considered.
For further details of how Plan Group Minimum Spend amounts are evaluated as against the Minimum Spend amounts defined for the Group's included Plans, see Plan Group Minimum Spends vs. Plans Minimum Spends.
Pricing. Only the line item for usage charges under that specific Pricing is considered and an extra line item is added to the Bill if needed to make up any shortfall against the Minimum Spend.
For example, you might have a single priced Plan on an Account:
Standing Charge is $20
Minimum Spend defined for usage charges per billing period is $50
For first billing period:
Calculated usage charges amount to $34.
Extra line item in the amount of $16 is added to reach Minimum Spend.
Total Bill 1 = $70
For second billing period:
Calculated usage charges amount to $54, which exceed Minimum Spend.
Total Bill2 = $74
Tip: Minimum Spend with Parent/Child Accounts? Note that a Minimum Spend amount is for the Product as a whole for an end customer Account that consumes the Product. If the customer Account has Child Accounts which have different pricing Plans attached, the Minimum Spend amount you enter for the Parent Account pricing Plan is reckoned at billing against the total usage charges due - for both Child and Parent. For more on billing for Parent/Child Accounts, see Billing Hierarchy Modes for Parent/Child Accounts.
When billing in arrears, Minimum Spend constraints can be assessed against usage charges that are known at the time of Bill calculation. When billing in advance, the method for applying a Minimum Spend is as follows:
Since the actual usage charges for a given billing period are not known before the Bill is drawn in advance, for each Bill in a series except for the last Bill, the Minimum Spend is applied. At the time of the next billing, the appropriate adjustment is made in light of the actual usage charges due for the previous billing period.
For example, suppose the Minimum Spend for a priced Plan is set at $50 and no Standing Charges are defined and the Account has no Prepayment/Commitment fees due.
At the time of first Bill, and before the actual usage charges due are known for the billing period to come, Minimum Spend is applied and therefore the usage total for Bill 1 = $50
If at the time of second billing, the actual usage charges due amount to $40, a refund item of $40 would be included in Bill 2 to ensure the customer does not end up paying $90 for usage in the first billing period.
Note that any refund amount is obviously capped at the defined Minimum Spend.
Next: Creating Plan Templates