Create subscriptions containing charges with annual prices and specific-month billing periods through the REST API
Create subscriptions with annual list prices and specific-month billing periods using the REST API, allowing for flexible billing arrangements.
With the Annual List Price feature, you can sell products and services with an annual list price, but bill your customers through contract negotiations according to a non-annual billing period through the REST API, for example, four months. The total billed amount for the annual service across multiple invoices equals the sum of the annual selling price.
Assume that you expect to define an annual list price of $21,500 for a recurring service, and bill your end customers every four months. You expect to send three invoices for the first year:
-
First invoice with the amount of $7166.67 $7166.67 is the rounded value based on the formula of 21500÷3. In this formula,
3represents the total number of billing periods of this year. -
Second invoice with the amount of $7166.66 $7166.66 is the rounded value based on the formula of (21500÷3)×2-7166.67. In this formula,
(21500÷3)×2represents the invoice amount of the first two billing periods, and7166.67represents the billed amount for the first billing period. -
Third invoice with the amount of $7166.67 $7166.67 is the rounded value based on the formula 21500-(7166.67+7166.66). In this formula,
(7166.67+7166.66)represents the total billed amount for the first two billing periods.
To achieve this goal through the REST API, complete the following tasks:
- Use the CRUD: Create a product rate plan charge operation to create a product rate plan charge with an annual list price of $24,000.
- Use the Create an order operation to create a subscription to the charge while updating the list price and billing period.