Monetization
Monetization
Monetization charges developers for your API plans through Stripe. It supports flat-fee, volume, graduated, and flat-fee plus overage pricing, prepaid credits, and usage-based metering.
Monetization charges developers for the plans they subscribe to in your API Portal. You connect a Stripe account once, then attach a price to each plan you want to bill for. Free and internal plans need no price at all.
How does monetization work in Apiable?
You connect Stripe under Integrations, then open a plan's Monetization tab and choose a revenue model. Apiable creates the matching price on your Stripe account and bills each subscriber through it. Usage-metered models report API calls to Stripe.
Monetization has two halves. You set the payment connection once for the whole account, and you set the price per plan:
- Connect Stripe. Link a Stripe account through Stripe Connect so Apiable can create prices and collect payment.
- Price each plan. On a plan's Monetization tab, pick a revenue model and set the amount, tiers, or credit rate.
- Bill subscribers. Apiable creates the price on Stripe and charges each developer who subscribes. Metered models report usage to Stripe.
Which payment providers does Apiable support?
Stripe, and only Stripe. Monetization resolves a Stripe configuration to its billing adapter and throws an error for anything else. There is no second payment provider you can connect today.
Which revenue models can charge a developer?
Four revenue models create a real billable price on Stripe: Flat-fee, Volume, Graduated, and Flat-fee plus Overage. Prepaid credits bill from a credit balance instead of a subscription. Free and Contract plans carry no price.
| Revenue model | Billable | How it charges | Usage-metered |
|---|---|---|---|
| Flat-fee | Yes | A fixed recurring price per billing cycle, created on Stripe. | No |
| Volume | Yes | Tiered price where the whole volume is billed at the tier it reaches. | Yes |
| Graduated | Yes | Tiered price where each tier's units bill at that tier's rate. | Yes |
| Flat-fee + Overage | Yes | A base flat-fee plus a per-unit charge above an included amount. | Yes |
| Prepaid credits | Yes | Burns down a prepaid credit balance per API call, topped up by invoice. | Tracked in a credit ledger |
| Free | No | No price. The plan is free to subscribe to. | No |
| Contract | No | No price. Shows a custom call to action, for example "Contact sales". | No |
In the dashboard, the Monetization tab first asks for a Revenue Model: Free, Contract, or Recurring. Choosing Recurring reveals a Pricing Model dropdown with Flat-fee, Flat-fee + Overage, Prepaid, Volume, and Graduated.
What does each pricing model do?
Four models create a billable Stripe price, Prepaid burns down a credit balance, and Free and Contract take no payment. Pick the one that matches how you want to charge.
- Flat fee. A fixed recurring price for each billing cycle, created on Stripe. The subscriber pays the same amount every cycle regardless of usage.
- Volume. A tiered price where the whole metered volume is billed at the rate of the tier it reaches. Usage-metered.
- Graduated. A tiered price where each tier's units bill at that tier's own rate, so the total is the sum across tiers. Usage-metered.
- Flat-fee plus Overage. A base flat fee that includes an amount of usage, plus a per-unit charge for usage above the included amount. Usage-metered.
- Prepaid burn-down. The subscriber holds a prepaid credit balance, and each API call burns it down at the per-call rate. Apiable tracks the balance in a credit ledger and tops it up by invoice, rather than running a standard Stripe subscription.
- Free. No price. The plan is free to subscribe to and charges nothing.
- Contract. No price. The plan shows a custom call to action, for example "Contact sales", so you route the developer to a sales conversation or an external checkout.
How does usage-based billing work?
Volume, Graduated, and Flat-fee plus Overage are usage-metered. Apiable records each API call as a usage event through the Stripe Meter API, and Stripe bills the metered total at the end of the cycle. You enable usage reporting on the plan.
Metered billing needs the Usage Events add-on, the plan's bill processing set to read API calls, and your API gateway logs connected so Apiable can count usage. See Usage-based billing for the prerequisites and matching criteria, or Report usage with the API to send usage yourself. For the why behind usage-based pricing, see API monetization.
How do prepaid credits work?
A developer holds a prepaid credit balance for the plan. Each API call burns down the balance at the per-call rate you set. Apiable records the balance in a credit ledger and issues invoices to top it up. This is the Prepaid pricing model, also called burn-down.
Prepaid credits do not run as a standard Stripe subscription. Apiable tracks the balance itself and uses invoices for top-ups, so the model has gateway and security requirements the dashboard enforces before you can select it.
Where do I price a plan?
You set pricing on a plan, not on the product. Open a plan and go to its Monetization tab, then choose a revenue model and fill in the amount or tiers. The tab also sets the billing cycle, tax handling, and a price lookup key.
Where to next
Connect Stripe
Link a Stripe account through Stripe Connect so Apiable can create prices and collect payment.
Usage-based billing
Meter API calls and bill them to Stripe, with the Usage Events add-on, gateway logs, and matching criteria.
Report usage with the API
Send usage to Apiable yourself with a request, for custom units or metering outside the gateway.
Price a plan
Open a plan's Monetization tab and choose a revenue model, then set the amount or tiers.