Overview
To ensure accurate billing for your customers whose subscriptions have usage-based pricing, you must record usage in Turnstile prior to the close of each billing period. You have the flexibility to determine how you track and record usage within the platform.
Before recording usage, configure your billable metric in Turnstile. You can then add usage data either manually or via the API.
Recording usage via API
Pros | Cons |
Fully automated billing where Turnstile can automatically send out all invoices | Upfront work to integrate |
Turnstile processes usage events asynchronously, so aggregated usage on upcoming invoices might not immediately reflect recently received usage events.
In this workflow, invoices are automatically issued via Stripe at the end of the billing period. Therefore, usage events must be added prior to the effective date in the timezone. All events added after the effective date will not be included on the invoice.
Recording usage manually
Pros | Cons |
No need to manually integrate with our API | Invoices need to be manually sent every billing period |
You can manually enter usage data from the Customer page or the Invoices workflow page in Turnstile.
Manually Adding Usage from the Customer Page
To manually add a usage event from the customer page, scroll to the Usage section and click the + to open the Add usage event pop up window.
When adding a usage event, enter the amount and select the date of the usage event. After adding the usage details, you have the option to enter additional usage events by clicking Save and add more or closing the window by clicking Save and finish.
Once the usage event(s) have been entered, Turnstile will immediately recalculate invoices to reflect the newly added data.
Manually Adding Usage from Invoices Workflow
Invoices with active usage periods (within 30 days) will appear in the In Progress section of the Invoice Workflow page. To view the invoices with active usage periods, click the In Progress tile and it will display the invoices in a table. To add a usage event, click the invoice from the table and it will open a side panel displaying the invoice details.
Click the plus icon in the product section of the side panel to open the Add usage event pop up window. When adding a usage event, enter the amount and select the date of the usage event. After adding the usage details, you have the option to enter additional usage events by clicking Save and add more or closing the window by clicking Save and finish.
Once the usage event(s) have been entered, Turnstile will immediately recalculate invoices to reflect the newly added data.