Custom Pricing
Set the retail prices your dashboard users pay, on top of your wholesale rates.
For dashboard partners
Retail prices apply only to dashboard orders paid through in-app checkout. Organization-billed orders — every API order, plus dashboard orders covered by your billing mode — always debit your balance at wholesale; retail prices never apply to them.
Every product has three prices from your organization's point of view:
| Price | Meaning |
|---|---|
wholesaleAmount | What FileForms collects. This is also the floor for your retail price. |
retailAmount | Your custom price — what your users pay. null until you set one. |
defaultAmount | The FileForms list price, used when you haven't set a retail price. |
Your margin on each in-app checkout order is retail − wholesale. State fees are always passed through as a separate checkout line item and are not part of these prices.
Setting prices
In the dashboard: Settings → Billing → Product pricing. Via the API:
curl -X PUT https://api.fileforms.com/v1/organization/prices/annual_report \
-H "x-api-key: sk_live_..." \
-H "Content-Type: application/json" \
-d '{ "retailAmount": 199 }'Prices are whole dollars. Setting a price below your wholesale floor returns 400:
{
"message": "Price must be at least $149. Contact FileForms about bulk credit purchasing to lower your wholesale rates.",
"minimumAmount": 149
}GET /organization/prices lists every product with all three amounts; DELETE /organization/prices/{type} reverts a product to the list price (404 if no custom price is set).
Disabling formation tiers
Each price row has an enabled flag, but only the formation tiers can be turned off (enabled: false on anything else returns 400), and at least one tier must remain enabled. Disabling a tier removes it from your users' dashboard checkout. It does not block API orders — those are governed by your integration, not the catalog.
Formation packages and registered agent
The tier 2 and tier 3 formation packages "include" registered agent service — but RA is an annual subscription, so it can't be folded into the one-time formation price. At checkout it's added as its own line item, and the package price your user sees is:
formation tier price + registered agent price (+ state fee)When pricing your formation packages, remember that raising or lowering your registered_agent retail price also changes the effective price of every tier 2 and tier 3 formation package.
Lowering your wholesale rates
Wholesale rates are set by FileForms. Partners with volume can negotiate bulk credit agreements that lower wholesale on specific products — contact FileForms. (If a new wholesale floor lands above one of your existing retail prices, that retail price is raised to the floor automatically.)