Automated seat-based billing

​

Concept

• You want your billing system to reflect any changes made to your product (e.g. a user adds a new license)
• You want to keep track of which seat was added or removed, and when
• You want to bill prorated amounts (e.g. a customer starts with 5 licenses but adds another one mid-year)

​

Practical Application

​

How to create an automated seat-based product?

1

Create a seat-based product

Navigate to the Products Section for this.

2

Activate Metering configuration

Ensure to choose the event you wish to count, as connected seats products are centered around an entity called an aggregator.The aggregator plays a crucial role in gathering data received by Hyperline.It determines whether the incoming data should be factored into the billing calculations, providing a more streamlined and accurate billing process.

3

Click on Create Product

That’s it! Your seat-based product should now be marked as “Connected seat”.

​

How to configure connected seats product in subscriptions?

​

Refresh schedule

• Realtime: The count updates immediately when a change is detected, instantly if you’re using the API, or based on the dataloader interval if you’re using loaders.
• Periodic: The count refreshes based on the interval entered by the user in the Refresh interval field. It’s independent of the subscription billing interval but can be matched to it.
• Manual: Users must trigger the refresh using the endpoint for a more customized experience.

​

Invoicing schedule

• Immediately: Hyperline charges (or refunds) the update as soon as it detects it, even in the middle of the period. If selected alongside the “periodic” option, it will simply invoice the customer at every “end” of period.
• With next invoice: Hyperline adds the update amounts to the next invoice as additional lines (so if the update is realtime but invoicing is at the end of the month, we’ll update the subscription count in realtime but will then add the charge to the next invoice).
• Custom: Allows the user to set an invoicing period, for instance, if they have an annual subscription they want to update in realtime but want to charge the update every month.

​

Other parameters

• Charging method: If prorata is selected, we’ll charge the units at the pro-rated rate given the product payment interval. Full amount means we’ll charge the entire price regardless of when the change is detected.
• Charge the highest detected value for the period: Instructs Hyperline to use the highest value it has counted regardless of the current one. Useful to always commit the maximum number of seats.
• Refund when a decrease in unit count is detected: Instructs Hyperline to count negative updates as refunds if they’ve already been paid.

​

Managing seat decreases

{
  "customer_id": "<customer_id>",
  "timestamp": "2024-03-15T10:00:00.000Z",
  "event_type": "users",
  "record": {
    "id": 258,
    "email": "[email protected]",
    "created_at": "2024-01-01T00:00:00.000Z",
    "archived": true
  }
}

• For a boolean field: add a filter where archived equals false

​

Billing calculation examples

​

End of period billing

​

Start of period billing

​

Explore consumption