Skip to content

Add docs guide: Going to Production with Monetization#1021

Merged
martyndavies merged 8 commits into
mainfrom
content/monetization-going-to-production
May 15, 2026
Merged

Add docs guide: Going to Production with Monetization#1021
martyndavies merged 8 commits into
mainfrom
content/monetization-going-to-production

Conversation

@zuplo-integrations-app
Copy link
Copy Markdown
Contributor

Summary

  • New docs guide covering the beta-to-production transition for Zuplo API Monetization
  • Addresses content gap identified in zuplo/www#2656 — multiple paying/about-to-pay customers could not find production rollout documentation
  • Includes pre-production checklist (8 items), billing model readiness matrix, Stripe live-mode cutover steps, known beta limitations, and Zuplo plan tier requirements
  • Fact-checked against Zuplo documentation via MCP tools

Content

Title: Going to Production with Monetization
Type: Docs Guide
Slug: articles/monetization/going-to-production

Files Changed

  • docs/articles/monetization/going-to-production.md — new guide (467 lines)
  • sidebar.ts — added page to Monetization → Guides section
  • docs/articles/monetization/index.mdx — added to documentation map table

Fact-Check Results

  • 32 claims verified against Zuplo documentation
  • Key verified items: beta status callout, Stripe restricted key permissions, metering architecture (Zuplo does not use Stripe Billing Meters), subscription lifecycle states, grace period configuration, billing models readiness
  • Corrections applied: Updated Enterprise plan description from "unlimited" to "custom" (matches pricing page), used "gateway developers" terminology consistently, softened single-subscription claim to match subscription-lifecycle.md, consolidated redundant beta messaging
  • No code example issues found — curl commands verified against API Access docs and Troubleshooting docs

Closes zuplo/www#2656

Generated with Claude Code

Pre-launch checklist, Stripe live-mode cutover, billing model readiness,
beta limitations, and plan-tier requirements for production monetization.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@zuplo-integrations-app zuplo-integrations-app Bot added the intercom-support Content opportunities identified from Intercom support conversations label May 14, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented May 14, 2026

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 15, 2026 5:19pm

Request Review

Convert going-to-production.md to .mdx and apply richer formatting
patterns from the Portal UI guide: Stepper components for sequential
instructions, ModalScreenshot wrappers, details/summary collapsibles
for beta limitations and troubleshooting, and tables for the
checklist summary, grace-period precedence, billing models, plan
tiers, support routing, and request payload fields.

Add an inline architecture diagram (D2 + Zuplo theme) clarifying
that Zuplo handles metering, plans, and subscriptions internally
while Stripe is used only for invoices and payment collection.

Add Portal and Stripe screenshots for the webhook-validation step
and the Stripe live-mode connect step (Payment Provider screen).

Correct webhook status copy from 200 to 2xx (Stripe deliveries
return 201 OK).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Replace em dashes throughout the going-to-production guide with
colons, sentence breaks, commas, or parentheses based on context
to align with the team's prose style.

Re-render the metering-flow diagram with reduced ELK padding and
larger font sizes on nodes, edges, and group labels so the diagram
is readable at typical doc-page widths.
Removed instructions for disconnecting and reconnecting Stripe from the Monetization Service's Payment Provider screen, you can't do that.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Comment thread docs/articles/monetization/going-to-production.mdx Outdated
martyndavies and others added 2 commits May 15, 2026 18:09
Clarified the currency field changeability in plans.
Comment thread docs/articles/monetization/going-to-production.mdx Outdated
Check billing readiness programmatically:

```bash
curl "https://dev.zuplo.com/v3/metering/$BUCKET_ID/billing-readiness" \
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This endpoint does not exist in dev api. It is only available for portal. cc @lcampos

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will remove for now, but this would actually be a handy thing to expose IMO

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@martyndavies martyndavies merged commit 8725aad into main May 15, 2026
13 of 14 checks passed
@martyndavies martyndavies deleted the content/monetization-going-to-production branch May 15, 2026 17:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

intercom-support Content opportunities identified from Intercom support conversations

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants