Skip to content

docs(monetization): correct what Zuplo creates in Stripe#1003

Merged
vazexqi merged 2 commits into
mainfrom
fix-monetization-stripe-creates
May 6, 2026
Merged

docs(monetization): correct what Zuplo creates in Stripe#1003
vazexqi merged 2 commits into
mainfrom
fix-monetization-stripe-creates

Conversation

@vazexqi
Copy link
Copy Markdown
Member

@vazexqi vazexqi commented May 6, 2026

Summary

Fixes the What Zuplo creates in Stripe section, which contradicted reality and the restricted-key permission scopes documented earlier on the same page.

  • Publishing a plan does not create Stripe Products, Prices, or Subscriptions. Verified by reading `PublishPlan` in `openmeter/openmeter/productcatalog/plan/service.go` — it only sets `EffectiveFrom`. No Stripe API calls.
  • Replaced the misleading Plan→Product mapping table with the list of objects Zuplo actually creates: Stripe Customers (on subscribe), Checkout Sessions, Customer Portal Sessions, Invoices and Invoice Items (at billing time), Tax Calculations (when enabled), and the Webhook Endpoint.
  • Fixed three matching contradictions in the same file:
    • "How it works" step 3 (claimed Products/Prices were created on publish)
    • "Connecting your Stripe account" line ("manage products, prices, customers, and subscriptions")
    • "Plan changes" step 1 ("The Stripe Subscription is updated with the new plan's prices")
    • "New subscription" step 1 ("Stripe Checkout Session is created with the selected plan's prices")

The corrected content now matches the restricted-key permission scopes already documented at lines 89-91 ("Zuplo doesn't use Stripe Subscriptions, Products, Prices, ...").

Test plan

  • Prettier formatting passes
  • Reviewer to spot-check the rendered page in preview deploy
  • Reviewer confirms intra-page anchor link `#what-zuplo-creates-in-stripe` resolves

Publishing a plan does not create Stripe Products, Prices, or Subscriptions;
the catalog stays in Zuplo. Replace the misleading mapping table with the
list of objects Zuplo actually creates (Customers, Checkout Sessions, Customer
Portal Sessions, Invoices, Tax Calculations, Webhook Endpoint) and remove the
matching contradictions in the "How it works" and "Plan changes" sections.
This now matches the restricted-key permission scopes already documented on
the same page.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 6, 2026 9:36pm

Request Review

Per review feedback, the section read oddly because it spent paragraphs
emphasizing what Zuplo doesn't create. Trim the intro and remove the
"Zuplo does not create..." paragraph; the table now stands on its own.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vazexqi vazexqi merged commit a13fd58 into main May 6, 2026
12 checks passed
@vazexqi vazexqi deleted the fix-monetization-stripe-creates branch May 6, 2026 21:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant