Marketplace | Dynamic Pricing for Usage-Based Billing (Create Wallet Charge API)

Modified on Fri, 22 Aug at 5:08 AM

The Marketplace team is excited to announce Dynamic Pricing for Usage-Based Billing. 

Common use case
: SMS services where the cost per message varies by destination.

What’s new?

Dynamic price support for usage-based billing via the Create Wallet Charge API.
A new request parameter: price lets app-developers set the per-unit price at charge time for services with variable costs.
Accounts can configure a flat per-unit markup when reselling the app's service (app reselling)

How to use it as a Developer?

A) Configure your billing meter

Go to App → Pricing → Billing Meters and create (or edit) a meter with Module Type = Custom Event (API).
Set Price Type: Dynamic
Enter Minimum and Maximum price, add a Pricing Page URL (recommended for transparency), and set a Default Price per Unit.
Save changes.

B) Charge the wallet via API

Use the existing
Create Wallet Charge API
. Include the new, optional price field when you want to apply a dynamic per-unit price for that charge.
If price is omitted, the meter’s Default Price per Unit is applied.

How to use it as an Account?

In your app’s Pricing section, end users see the price range for dynamic meters and a link to the Pricing Page URL.
Visibility note: The Pricing Page URL is visible to your account admins only, not to your account.

Reselling & markup behavior (your account)
Your account can configure a flat per-unit markup when reselling apps' service (app reselling).
Because markups change effective end pricing, the Pricing Page URL is hidden from your account to avoid confusion.

Example: If an SMS base price is $1.00 (UK) and $1.50 (France), your account can add a $0.50 markup so your account pays $1.50 (UK) and $2.00 (France).
Let me know if you'd like further adjustments!

Why this is important

Match real-world costs
: Many services (SMS, telephony, geo-based APIs) have variable costs. Dynamic pricing lets you pass the right price at the moment of charge.
Clear, upfront expectations
: Min/Max price ranges and a Pricing Page URL give buyers transparency into how pricing can vary.
Supports growth via resellers
: Account markups create healthy margins and incentives to promote apps, helping distribution without extra engineering.