Fill in the form to arrange a demo

Metered Billing for Subscriptions

If you’re charging in arrears for a consumable service, you can implement a metered billing setup with a few additional updates to your Paddle integration. This can be implemented in a couple of ways.

To implement metered billing, you will need to calculate the amount due on your own platform. For customer transparency, you should calculate the value of the service consumed a few days ahead of the billing date and distribute a billing notification so that your subscribers are aware of the upcoming charge.

Paddle Subscriptions are set to bill a fixed amount at a regular interval, however there are a couple of ways that you as a Seller can charge in arrears: either by adding an amount to an existing subscription, or by making a one-time charge with the required amount.

You can use either of the following approaches for metered billing:

Using the Charges API

The Charges API allows you to make an immediate charge on top of an existing subscription. To use this approach:

  • At a fixed time before the next billing date, calculate the value of the consumed service. You can retrieve the next billing date via the List Users API.
  • On the billing date, call the Charges API with amount that you would like to charge.

The buyer will be charged the amount right away. Please note that this is not a recurring charge so you will need to perform the same steps for the next billing cycle.

Learn more about the Charges API and implementation here.

Using Subscription Price Modifiers

Subscription Price Modifiers either add or subtract a fixed amount from the subscriber’s upcoming bill.

  • At a fixed time before the next billing date, calculate the value of the consumed service. You can retrieve the next billing date via the List Users API.
  • Create a new Price Modifier to add the value above to the upcoming bill. This can be added through the Price Modifier API:

curl -X POST -d 'vendor_id=123' \
             -d 'vendor_auth_code=1a54229abfcfa...' \
             -d 'subscription_id=12345' \
             -d 'modifier_recurring=false' \
             -d 'modifier_amount=10.00' \
             -d 'modifier_description=Example%20Description' \
             https://vendors.paddle.com/api/2.0/subscription/modifiers/create

Note: the modifier should not be set to recur. The currency of the modifier will be the same currency as used in the current subscription. You should add a description to the modifier to explain the reason for the charge.

  • The subscriber will be charged an additional amount at the start of their next bill.

Sending Billing Notifications

As the billing amount changes in each billing period, we recommended that you enable pre-billing notifications when using subscription price modifiers for metered billing.

In your dashboard Vendor Settings, select ‘Subscriptions’. From there you can enable up to two billing notifications before payment is taken. Ensure that the first notification is sent out after the pricing update is made.

Questions about Paddle?

If you need any help regarding your Paddle integration, please get in touch with our Customer Success team using the form below.

Questions about Paddle?