Overview
Monetary usage pricing lets a usage brick meter a dollar amount instead of a count of units, and price that amount as a percentage. This is the model behind revenue share, take rates, payment processing fees, and any arrangement along the lines of “we charge 1.39% of everything that flows through the platform.” Pricing this way has always been possible in Salesbricks by setting a fractional per-unit rate and sending cents as the metered quantity. Monetary usage pricing makes it explicit: you choose dollars as the unit, you enter the rate as a percent, and every downstream surface (the brick pricing modal, the order form pricing breakdown, pre-commitments, invoices, and usage charts) displays it that way.Whole units vs. Monetary
Every usage brick’s pricing now carries a Unit type. It controls how the quantity is entered and displayed, and which rate format goes with it.Unit type only appears on usage bricks. Subscription, one-time, and milestone bricks are always priced in currency per unit.
Setup
1
Open the brick's pricing
Go to Products, select a product, then a plan, and click the edit icon.Scroll to the “Bricks” section and click Edit bricks. Hover over the usage brick you want to price and click the edit icon.
2
Choose Monetary as the unit type
In the Unit type selector, choose Monetary.Selecting Monetary automatically switches the rate format to a percentage.
If you don’t see a Unit type selector, monetary usage pricing isn’t enabled for your account yet. Ping us in your dedicated Slack channel or email support@salesbricks.com.
3
Pick a structure and enter the rate
Choose Flat-rate, Tiered, or Volume (see pricing structures), then enter the percentage rate. Fractional percentages are supported, so
1.39 is a valid rate.For tiered and volume structures, the tier bounds are entered as dollar amounts rather than counts.4
Save and republish
Save the brick pricing, then publish the plan version so the pricing is available to select on an order.
Sending usage
Usage is always recorded in the smallest denomination of the currency (cents) through the same usage endpoint you already use. Salesbricks converts the stored count into a dollar amount for display, where 1 metered unit = 1 cent.How the charge is calculated
The charge is the metered dollar amount multiplied by the rate.Charge = metered amount × (rate ÷ 100)
- Metered amount for the month: $250,000
- Rate: 1.39%
- Charge: $250,000 × (1.39 ÷ 100) = $3,475.00
For $250,000 of metered volume:
- $100,000 × 2.00% = $2,000.00
- $150,000 × 1.50% = $2,250.00
- Total: $4,250.00
Where it appears
ChoosingMonetary changes how the brick is presented everywhere the quantity or rate is shown:
- Brick pricing modal: the rate card renders as a Tier / Rate table with percentage rates, and tier bounds are entered as currency.
- Order form pricing breakdown: the breakdown interleaves the rate card with the distribution across bands, so the buyer sees which portion of the amount is priced at which percent.
- Pre-commitments and overage: a pre-committed amount is expressed in dollars, and the overage rate is entered as a percentage.
- Ramping schedules: each ramping period’s committed amount and rate follow the same formatting.
- Invoices and subscription management: invoiced quantities and the usage charts display dollar amounts.
Things to know
- Unit type lives on the pricing, not the brick. The same brick can be priced in whole units on one plan and monetary on another.
- Percentage rates require a monetary unit type. The two settings are validated together, so a percentage rate cannot be attached to a whole-units brick.
- Metering and storage are unchanged. Only entry and display differ, so switching an existing integration is a pricing change, not a data migration.
- Pricing is set per plan version. Changing a published brick’s unit type means creating and publishing a new plan version; existing subscriptions keep the pricing they closed on.