Welcome friend!

Welcome to Upodi Docs. You'll find comprehensive help, guides and developer information to help you get started with the basics and move to the advanced flows. Let's jump right in!

I am a User I am a Developer


Besides handling pricing models with various product plans, Upodi support discounting at several levels of the billing cycle. Discounts are percentage (%) based calculations which will deduct cost from the price and billing of an invoice.

Discounts are created by navigating to Product Catalog > Discounts.

Discount settings




Full name

No restrictions

Will not be displayed anywhere. It is for internal use only.


Numeric value, %percentage

Will be displayed on the invoice under a separate column called "Discount".

Invoice text

No restrictions

Will be displayed on the invoice lines where the discount applies.

Discount type


We only support a percentage discount. More types to follow.

Expire after

Numeric value * Chosen interval

This means the discount will automatically expire x time after it has been applied.


Expire After Edge Case

Having an expire after interval lower than your billing cycle will not calculate the exact cost of the interval. A discount will always give the full discounted amount while active.

For example having a yearly billing cycle and a discount with expire after one month. The discount will apply to the entire invoice, while being active on the invoice date.

Applying a discount

Once a discount is created the discount can be applied to the following levels of a billing:

  • Customer level. The discount will be applied to the customer, and all subscriptions, and all subscription charges below.
  • Subscription level. The discount will be applied to the current subscription and all subscription charges below. If a given subscription charge has a discount applied, this discount will overrule.
  • Subscription charge level. The discount will be applied to the subscription charge and carried forward for each billing cycle. Only the specific subscription charge will be discounted. This is applied by viewing an active subscription under Subscription Charges.

If there are several discounts on different levels the most specific discount will overrule. For example if a given subscription has a discount applied, that discount will overrule any potential discount applied at the customer level.

Partner discount modelling

You can use the discount feature of Upodi, combined with parent billing to apply partner based discount fees to customers who is set to bill to parent. It is a common scenario to apply partner based rebates across customers.

In case of parent billing and discounting, each customer is first calculated using the discount approach discribed above, and then the partner discount is re-applied overall.

Discounts are coupled with discount codes.

Restricting discounts

Discounts may be restricted to certain product plans. In this case, you cannoy apply discounts on customer level. Restrictions on discounts enable certain eligability scenarios to apply.


We're always happy to help with code or other questions you might have! Search our documentation or contact helpdesk. You can also chat live with us using the Intercom icon.

Updated 4 months ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.