Reference guide

How Sponti is structured

Sponti has a clear entity model. Understanding how each piece relates to the others makes the whole system intuitive to navigate.

The big picture

The chain at a glance

Everything in Sponti flows in a simple hierarchy:

๐ŸขBusiness
โ†’
๐Ÿ“Venue
โ†’
๐Ÿ“ฆProduct
โ†’
๐ŸŽฏDeal

A Business is your storefront. It has one or more Venues (physical locations). You build a Product catalog (reusable templates), and publish Deals from those products at specific venues.

Supporting this are two more entities: the Account (your Stripe payout connection) and your Team (the people who manage the business with you).

Relationships

One business, many things

Each business is the root of its own world. Here is exactly how many of each entity a business can have:

๐Ÿ“Venues
Business 1 โ†’ many Venues

A business can have one venue or many โ€” each a separate physical location.

๐Ÿ“ฆProducts
Business 1 โ†’ many Products

A business can list as many products as it offers. Each is a reusable template.

๐Ÿ’ณPayout account
Business 1 โ†’ 1 Payout account

Each business has exactly one Stripe payout account. This is strict.

๐Ÿ‘ฅTeam members
Business 1 โ†’ many Team members

A business has one Admin and any number of Co-admins, Managers, and Members.

๐ŸŽฏDeals
Business 1 โ†’ many Deals

Deals are created from products. A business publishes as many deals as it has capacity for.

๐Ÿ’ก Tip

The payout account is 1-to-1 on purpose. One business equals one Stripe account, which keeps accounting clean and compliance straightforward. If you operate two genuinely separate businesses, create two separate Businesses in Sponti โ€” each with its own payout connection.

The entities

Each entity explained

๐Ÿข

Business

Your storefront on Sponti

The Business is the top-level entity. It represents your brand or company โ€” what customers see and recognize. It holds your display name, logo, gallery, support contacts, and category. A user can create multiple businesses. A business must be verified before its deals are visible to customers.

Contains / enablesMany venues ยท Many products ยท Many team members ยท One payout account ยท Many deals
๐Ÿ“

Venue

Where the deal takes place

A Venue is a physical location under your business โ€” a branch, shop, studio, restaurant table, hotel, or event space. Venues carry a name, address (set by map pin), country, state, and timezone. The timezone is used to resolve deal timing โ€” customers see local times, not UTC. One Business can have multiple Venues.

Belongs toBusiness
Contains / enablesDeals
๐Ÿ“ฆ

Product

The reusable deal template

A Product is a template for a deal โ€” a haircut, a yoga class, a room type, a dinner menu, a mystery box. You create products once in your catalog, then publish deals from them at any time. Products define the deal type (appointment, walk-in, ticket, pickup, or stay), the title, cover image, and service configuration.

Belongs toBusiness
Contains / enablesDeals (via publication)
๐ŸŽฏ

Deal

What customers actually book

A Deal is a time-limited, discounted offer published from a Product at a specific Venue. Deals are created by opening a product in your catalog and tapping 'Create deal' on it โ€” not from a standalone screen. Each deal has a start time, end time, original price, deal price, and availability count. When a customer books, the slot count decreases by one. Once the count reaches zero or the window closes, the deal ends.

Belongs toBusiness (via one Product + one Venue)
๐Ÿ’ณ

Account

Your Stripe payout connection

The Account is the payout entity โ€” your Stripe Connect account linked to this business. It handles all payments and payouts. A business has exactly one account (1:1 relationship). Without a connected account, deals from this business cannot be published. Account statuses: missing, setup, pending, connected, rejected. Only Admin and Co-admin can manage the account.

Belongs toBusiness (exactly one per business)
๐Ÿ‘ฅ

Team

The people who run the business

A Team is the set of users with access to a business. Each member has one of four roles: Admin (full access), Co-admin (same as Admin, for co-owners), Manager (can manage deals and catalog, no payout access), or Member (view and limited operational access). Invitations are sent and accepted through the Sponti app.

Belongs toBusiness

How they connect

Entity relationships

To publish a deal, these relationships must exist:

RequirementWhy
Business must be verifiedDeals from unverified businesses are not visible to customers
At least one VenueEvery deal needs a physical location
At least one ProductDeals are created by tapping a product in your catalog
Account status = connectedPayments require a fully onboarded Stripe account

๐Ÿ’ก Tip

Start by creating your Business, then add a Venue, then create a Product, then set up your Account. After that, you're ready to publish your first Deal. See the publish guide โ†’