Skip to content
Protocolzone Protocolzone

Distribution module

Aggregator and operator management

Adding an operator is configuration and a connector, not a release.

Part of the Ashva module inventory — a multi-tenant tote and fixed-odds betting platform we built and operate. The engineering practice behind it is our platform build and integration service line.

The question that decides whether a multi-tenant wagering platform is actually multi-tenant: how long does it take to bring the next operator live, and does doing so require a release?

If onboarding needs a code change, the platform has one tenant and a set of special cases.

The tenant record is the unit of configuration

An operator is a tenant record holding jurisdiction, product entitlements, limits, branding, commercial terms and credentials. Every service scopes data access by tenant at its own boundary. Isolation enforced at the presentation layer is not isolation, it is a filter waiting to be forgotten in one query.

Entitlements enforce the licence

Codes, markets, bet types and modules available to an operator are held centrally and enforced by the platform. An operator cannot be accidentally configured into a product its licence does not permit, because the constraint lives with the tenant record rather than in an operations runbook.

Connectors absorb partner variation

Aggregators and downstream operators each have their own idea of what a bet message looks like. Those differences are handled in per-tenant connectors that translate to a stable internal contract. The alternative, conditional logic in the core wagering path keyed on partner identity, is how a platform becomes unreleasable.

Reporting cuts both ways

Each operator sees its own turnover, settlement, exposure and activity. The platform holder sees the consolidated position across operators, which is the only place correlated exposure across brands is visible. Both views come from the same reconciled data, described in the reporting and exposure module.

What this module does not do

It does not price, accept or settle bets. It decides who is on the platform, what they are allowed to offer, how their interface is shaped and how their activity is reported.

Module facts

Module group
Distribution
Tenancy
Tenant-aware
Bet types
Fixed odds, Tote, Pari-mutuel, Exotics, Multi, Starting price, Same-race multi
Codes and verticals
Thoroughbred, Harness, Greyhound, Sports, Esports

Integration surfaces

  • Aggregator and downstream operator APIs
  • Per-tenant connectors for partner-specific interface shapes
  • Identity and credential issue for operator API access
  • Ledger and settlement for per-operator reconciliation
  • Reporting and exposure module for per-tenant position

Capabilities

What aggregator and operator management actually does.

Tenant records and isolation

Each operator exists as a tenant record carrying its jurisdiction, product entitlements, limits, branding and commercial configuration. Data access is scoped by tenant at the service boundary, not filtered in the presentation layer.

Onboarding path

A defined sequence for bringing an operator live: tenant creation, entitlement and product configuration, credential issue, connector deployment, then verification against a checklist rather than against someone's memory of the last onboarding.

Entitlements and product availability

Which codes, markets, bet types and modules an operator may offer, held centrally and enforced by the platform so an operator cannot be configured into a product its licence does not cover.

Credentials and API access

Per-operator credentials and API keys with scoped permissions, rotation, and revocation that takes effect at the boundary immediately.

Per-tenant connectors

Where an operator or aggregator needs its own interface shape, that translation is deployed as a per-tenant connector against a stable internal contract, so one partner's requirements do not leak into the core platform.

Commercial configuration

Commission, rate and fee structures configured per operator and applied consistently to reporting and reconciliation.

Per-operator reporting

Turnover, settlement, exposure and activity reported per operator, with the operator seeing its own position and the platform holder seeing the consolidated view.

Other distribution modules

Working on this problem yourself?

We will go through how this module handles it, what it deliberately does not do, and where we would make a different call today.