Skip to content

Add monetization documentation#928

Open
ntotten wants to merge 6 commits intomainfrom
ntotten/monetization-docs
Open

Add monetization documentation#928
ntotten wants to merge 6 commits intomainfrom
ntotten/monetization-docs

Conversation

@ntotten
Copy link
Member

@ntotten ntotten commented Mar 19, 2026

Summary

  • Adds 8 new monetization docs: quickstart, billing models, Stripe integration, developer portal setup, monetization policy reference, subscription lifecycle, migration guide, and troubleshooting
  • Reorganizes sidebar into Concepts, Guides, and Reference categories
  • Updates overview page with improved structure and content
  • Adds redirects in vercel.json for removed pages (concepts → meters, api-reference → api-access)
  • Preserves existing accurate .mdx reference docs (meters, features, plans, rate-cards, pricing-models, api-access)

Review notes

New docs were reviewed against the core (madrid), gateway-service (zagreb), management-api (seoul), and developer-api (ottawa) codebases. Fabricated content from initial drafts was corrected to match the actual OpenMeter-backed API — including field names (featureKey not featureSlug), nested price objects with string amounts, entitlementTemplate structure, and policy behavior (403 responses, no rate-limit headers, policy handles auth directly).

Test plan

  • Verify build passes (npm run build)
  • Check all internal links resolve
  • Review JSON code examples against the actual API
  • Verify sidebar navigation structure

🤖 Generated with Claude Code

New docs covering Stripe integration, developer portal setup, monetization
policy reference, subscription lifecycle, migration guide, billing models,
and troubleshooting. Reorganized sidebar into Concepts, Guides, and Reference
categories. Updated overview page and added redirects for removed pages.

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

vercel bot commented Mar 19, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Mar 24, 2026 9:18pm

Request Review

- Add zuploMonetizationPlugin setup instructions (developer-portal, quickstart)
- Fix Stripe connection to API key approach, not OAuth (stripe-integration, quickstart, migration-guide)
- Add getMeters() method and merge behavior docs (monetization-policy)
- Add proRatingConfig plan property (plans)
- Add paymentTerm, preserveOverageAtReset, usagePeriod to rate cards (rate-cards)
- Fix API paths from v1 to v3 (subscription-lifecycle, troubleshooting, migration-guide)
- Remove fabricated webhook section from troubleshooting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add caution note to pay-as-you-go billing model (not fully tested yet)
- Rewrite quickstart to use portal UI flow instead of API-first approach
- Add private plans documentation (invite-only subscriptions)
- Add tax collection documentation (Stripe Tax / VAT)
- Replace Mermaid diagram in plans.mdx with Diagram components
- Remove migration guide (v1 migration)
- Update sidebar and overview with new pages

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
ntotten and others added 2 commits March 24, 2026 16:57
Replace all "preview and subject to change" warnings with a beta note
across all 17 monetization docs. The new note communicates that the
feature is stable for evaluation, free during beta, and requires
contacting Zuplo for production use.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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