new
App Marketplace
API
Marketplace | Dynamic Pricing for Usage-Based Billing (Create Wallet Charge API)
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.
- Agencies 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 Agency?
- 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 agency admins only, not to sub-accounts.

Reselling & markup behavior (agencies)
- Agencies 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 sub-accounts to avoid confusion.
- Example: If an SMS base price is $1.00 (UK) and $1.50 (France), an agency can add a $0.50 markup so sub-accounts pay $1.50 (UK) and $2.00 (France).

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: Agency markups create healthy margins and incentives to promote apps, helping distribution without extra engineering.