Billing presets

A preset is a named set of billing rules. Instead of configuring 7 separate policy knobs, you pick a preset that fits your business model and you’re done. You can always override individual settings afterward.

The five presets

SaaS-Standard

Recommended starting point. Immediate upgrades, downgrades at period end, 7-day grace, block changes while past due.

Lenient

For B2B or high-value customers where churn is costly. 14-day grace, no change restrictions.

Strict

For services where access is tightly tied to payment. 3-day grace, block all plan changes while past due.

Transfer-First

For customer bases that primarily pay by bank transfer. 21-day grace window, very lenient dunning.

Postpaid / Arrears

Arrears billing mode, 14-day grace. For enterprise contracts and usage-based models.

Comparison

Preset	Upgrade timing	Downgrade timing	Grace period	While past due
SaaS-Standard	Immediate, prorated	At period end	7 days	Block upgrades
Lenient	At period end	At period end	14 days	Allow everything
Strict	Immediate, prorated	Immediate credit	3 days	Block all changes
Transfer-First	Immediate, prorated	At period end	21 days	Allow everything
Postpaid / Arrears	Immediate, prorated	At period end	14 days	Block upgrades

Apply a preset

curl -X POST https://api.useplinth.com/v1/tenant/apply-preset \
  -H "Authorization: Bearer sk_test_DOCS_SHARED_KEY" \
  -H "Content-Type: application/json" \
  -d '{"preset": "saas_standard"}'

Valid preset names: saas_standard, lenient, strict, transfer_first, postpaid.

Override individual knobs

PUT /v1/policy to change any knob without switching preset:

Knob	Values	Controls
`activation_strategy`	`activate_then_charge` · `charge_to_activate`	Access before vs after first payment
`upgrade_strategy`	`immediate_prorated` · `at_period_end`	When an upgrade takes effect
`downgrade_strategy`	`at_period_end` · `immediate_credit`	When a downgrade takes effect
`change_during_dunning`	`gate_upgrades` · `block_all` · `allow_all`	Plan changes while past due
`cancel_policy`	`end_of_period` · `immediate`	When a cancel takes effect
`grace_days`	integer	Grace window before `delinquent`
`allow_multiple_subscriptions`	`false` (default) · `true`	Allow a customer more than one live subscription per plan-group

curl -X PUT https://api.useplinth.com/v1/policy \
  -H "Authorization: Bearer sk_test_DOCS_SHARED_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "cancel_policy": "immediate", "grace_days": 3 }'

After applying

The preset updates your TenantPolicy. Existing subscriptions aren’t affected retroactively — only new billing cycles apply the new rules. If you need to change behaviour for an in-flight subscription, contact support or use a per-subscription override.

​The five presets