Skip to main content

Ripple – Invoiced Service Settings

How to Add Custom Billing Services to Invoices in Ripple

Written by Alphaus Support Team
Updated today

Overview

This guide walks you through how to configure and add custom billing service fields to Billing Groups in Ripple.

The following charge configuration options are available:

  • Fixed fee

  • Percentage (%)

  • Fixed fee, Percentage or whichever is higher

  • Tiered Price

  • Tiered Price with Percentage


How to Configure Billing Services

  1. From the left menu, go to Settings > Invoiced Service Settings and click Create New Service

  2. Enter the basic information

  3. Configure the charge method (fixed amount, percentage, or whichever is higher) and click Save

  4. Navigate to Account/Group > Billing Groups and select the account you want to add the billing service to > Edit Billing Group

  5. Click the Invoiced Services tab > check the service and the target (Billing Group or Account) you want to charge to and click Save

  6. Generate the invoice — the billing service will be reflected in the invoice

Notes The billing service can be applied at the Billing Group level or at the individual Account level. The Linked Account option is greyed out if no accounts are linked to the Billing Group. Each billing service displayed can be sorted and selected as needed.


Invoice Display

When configured at the Billing Group level, the billing service appears as a Billing Service line item directly above the overall invoice subtotal.


Calculation Method

When a billing service is set as a percentage of usage charges, the amount is calculated as follows:

Usage after discount (default):

  1. Apply the exchange rate to each service's usage (USD) and convert to your billing currency

  2. Calculate the post-discount amount per service in your billing currency

  3. Apply rounding based on the settings in Settings > Invoice Settings

  4. Sum all amounts from step 3

  5. Apply the billing service percentage to the total

  6. Apply rounding based on Settings

Usage before discount:

  1. Apply the exchange rate to each service's usage (USD) and convert to your billing currency (using pre-discount amounts)

  2. Apply rounding based on Settings > Invoice Settings

  3. Sum all amounts from step 2

  4. Apply the billing service percentage to the total

  5. Apply rounding based on Settings

Notes If cost items from Adjusting Entries (such as fees, credits, or discounts) are applied to the invoice, they are included in the usage amount for the billing service calculation.

Billing Service Usage Calculation Formula

AWS Service Charges + Applied Adjusting Entries items = Usage amount

Important Notes

  • To apply billing service changes to a previously generated invoice, select the edited Billing Group on the invoice creation page, then go to Edit Settings > your Cloud Provider and click Revert to Billing Group settings

  • A CustomService column will be added to the Ripple billing data download CSV. No other fields or formats will be affected

  • For tag-based Billing Groups, billing services can only be linked at the Billing Group level — linking per tag is not supported

  • When using table-based pricing, the "greater than or equal to X amount" condition is not currently supported. If needed, set the maximum value to 1,000,000,000 (1 billion) in your billing currency as a workaround


Need More Help?

If any errors occur during the process or if you have any questions, please reach out to us:

Did this answer your question?