Overview
Additional costs are one-off custom charges you can attach to a subscription outside of the plan price, add-ons, or usage-based billing products. They appear as individual order lines on the next invoice and let you bill for anything that falls outside your standard plan structure without creating a new plan. Additional costs are billed once.
Note
Additional costs are different from add-ons (predefined products with their own configuration) and usage-based billing products (automated metered charges). Additional costs are manual, free-form order lines you define per subscription.
When to use additional costs
Additional costs are useful in any situation where you need to charge a customer for something that is not covered by their plan or add-ons. Additional costs can be added for the following scenarios, for example:
Physical goods & fulfillment
Shipping or delivery fees for a subscription box or physical product shipment
Packaging or gift-wrapping surcharges for a specific order
Service adjustments
Rush or expedited processing fee for an urgent request
Manual correction for a previous billing error (adding a charge that was missed on an earlier invoice)
Fees & penalties
Late payment or reminder fee for an overdue invoice
Currency conversion or bank transfer fee passed through to the customer
Seasonal/situational
Holiday or peak-season surcharge
Compliance or certification fee tied to a regulatory requirement
How additional costs are billed
When you add an additional cost to a subscription, it is queued as a pending cost. It does not trigger an immediate invoice. Instead, it is picked up automatically and included as an order line in the next scheduled invoice for that subscription. Each additional cost order line displays its own description, quantity, unit price, and VAT rate on the invoice.
Good to know
You can add multiple order lines in a single additional cost entry. All lines added together are collected in the Pending costs and credits section of the subscription and consolidated on the next invoice.
Add additional costs at subscription creation
You can add additional costs while creating a new subscription, in the Subscription options section of the subscription form.
Navigate to Customers → Customers, open a customer, scroll to the Subscriptions box, and click on Create Subscription.
Select a plan and adjust quantity or price if needed.
In the Subscription options section, click Add cost.
Enter a Description, Quantity, Price, and VAT rate for each line. Click Add order line to add further lines.
Complete the remaining sections and click Submit to create the subscription. The additional costs are queued and will appear on the first invoice.
Add additional costs to an existing subscription
You can add additional costs to a subscription at any time from the subscription details page. The costs are held in the Pending costs and credits box until the next invoice is generated.
Navigate to Customers → Customers, open the customer, and click the relevant subscription. Alternatively, go to Subscriptions in the sidebar and open the subscription directly.
Scroll to the Pending costs and credits box and click Add cost.
Enter a Description, Quantity, Price, and VAT rate. Click Add order line to include additional lines.
Click Confirm. The cost is now listed in Pending costs and credits and will be included on the next scheduled invoice.
Once confirmed, the pending costs are visible in the list. Click the arrow next to an entry to expand the details.
