diff --git a/agent.html b/agent.html index fd6f61b..f70ef0f 100644 --- a/agent.html +++ b/agent.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy diff --git a/index.html b/index.html index 741cd5c..8cb176e 100644 --- a/index.html +++ b/index.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy @@ -110,6 +111,34 @@

A product can have one policy or many. Multi-tier ladders (think Basic / Pro / Max) are first-class: when a product has two or more public policies, the buy page renders a tier picker and the buyer chooses before paying. The displayed tier is selected from a ?policy=<slug> URL hint, then the highlighted ("most popular") policy if any, then the cheapest. Tier ordering on the picker is operator-controlled via drag-and-drop in the admin UI (or tier_rank in the API).

You can also attach private policies for manual issuance, e.g. a longer-duration "Lifetime" comp for conferences, a richer-entitlement "Internal" tier for support cases. Private policies don’t appear on the buy page; the admin API issues them directly.

+

Merchant profiles

+

By default a Keysat instance sells for one business. On first boot it creates a single default merchant profile from your operator name, and every product you create attaches to it. If you only ever run one business, you can ignore profiles entirely: everything works against the default.

+

On the Pro and Patron tiers you can run more than one business from the same instance. A merchant profile is one business identity, and it owns:

+ +

So one operator, on one Start9, can sell Recaps under the Recaps brand (settling to the Recaps wallet) and Aurora under the Aurora brand (settling to the Aurora wallet) side by side, with separate checkout branding and separate books. Keysat is still not a shared SaaS: two independent sellers each run their own box. What profiles add is multiple businesses under one operator.

+ + + + + + + + + +
ConceptWhat it is
Default profileAuto-created on first boot, exactly one per instance. A product with no explicit profile resolves to it.
Payment providerOne configured BTCPay or Zaprite account, attached to a profile. A profile can have more than one.
RailA buyer-facing payment method: Lightning, on-chain, or card. BTCPay serves Lightning and on-chain; Zaprite adds card.
Rail preferenceA tie-breaker for when a profile has two providers that both serve the same rail: it sets which one wins.
+ +

Manage all of this in the admin UI under Merchant profiles: create a profile, set its branding, connect BTCPay or Zaprite to it, mark one as the default, and attach products. Connecting a provider to a profile uses the same one-click authorize handshake as Connect BTCPay in setup, just scoped to the profile you start it from.

+ +
+ +

Running one business? Skip this. The default profile is created for you and every product uses it automatically. Merchant profiles only start to matter when you want a second brand or a second wallet on the same instance, which is a Pro and Patron capability.

+
+

Discount codes

Four kinds:

@@ -182,6 +211,7 @@
On this page
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy Operator tiers diff --git a/install.html b/install.html index 59d6c0a..1a77c05 100644 --- a/install.html +++ b/install.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy diff --git a/integrate.html b/integrate.html index cbaf886..e1250cb 100644 --- a/integrate.html +++ b/integrate.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy diff --git a/license.html b/license.html index 7d16641..83c05db 100644 --- a/license.html +++ b/license.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy diff --git a/operate.html b/operate.html index b0f0331..d317150 100644 --- a/operate.html +++ b/operate.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy diff --git a/pricing.html b/pricing.html index db77c61..47a8413 100644 --- a/pricing.html +++ b/pricing.html @@ -90,6 +90,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy diff --git a/wire-format.html b/wire-format.html index f762bc8..f526e67 100644 --- a/wire-format.html +++ b/wire-format.html @@ -27,6 +27,7 @@
Concepts
Architecture Products & policies + Merchant profiles Discount codes Revocation strategy