# Commercial Agreements

> Versioned configuration that controls how fees apply to operations, split between platform-level and enterprise-level agreements. Coming soon.

Source: https://business-api-docs.youhodler.com/docs/concepts/commercial-agreements

A `CommercialAgreement` is the versioned configuration that controls how
fees are applied to operations inside a tenant scope. The platform models
two distinct levels: a platform-level agreement between the platform and
the enterprise, and an enterprise-level agreement between the enterprise
and its end clients.

> **Coming soon:** Public API surfaces for `EnterpriseCommercialAgreement` are being redesigned. This page will document the canonical model — versioning, effective windows, fee resolution at runtime — when those surfaces become public. Track the release notes for the timing.

## What Belongs Here

When this concept lands, it will cover:

- the split between `PlatformCommercialAgreement` and
`EnterpriseCommercialAgreement`
- versioning through `effective_from` / `effective_to` and the append-only
rule for published versions
- how runtime fee resolution picks the active version for an operation
- the distinction between a commercial agreement (configuration) and a
commercial agreement outcome (the realized application of fees on a
specific operation)

Until then, treat commercial agreements as platform-managed configuration
that you observe through fees on operations rather than configure
directly.