Back to registry
+ Feature / Extension ✓ Validated Updated Not dated

Stripe Billing Extension

A portable blueprint for adding paid SaaS billing to an existing backend: checkout, subscriptions, customer portal, webhooks, entitlement checks, and billing settings.

Package JSON
What this builds

A scoped product implementation packet.

A practical extension Buildprint for the paid-app foundation coding agents often implement incompletely.

  • Stripe checkout flow
  • Subscription and trial handling
  • Customer portal entry point
  • Verified webhook handler
  • Server-side entitlement checks
  • Billing settings UI
Core capabilities

The useful parts the finished build should expose.

01 Stripe checkout flow
02 Subscription and trial handling
03 Customer portal entry point
04 Verified webhook handler
05 Server-side entitlement checks
06 Billing settings UI
What you need

Local first, live proof explicit.

Mock/local: Nothing for mocked/local billing tests

  • Stripe account and API keys for live billing
  • Webhook signing secret for production webhooks
  • Product/pricing decisions from the human
System shape

What kind of artifact this becomes.

Product surface

A practical extension Buildprint for the paid-app foundation coding agents often implement incompletely.

Runtime layer

Any backend, TypeScript proof

Build materials

Checkout / Webhook / Subscription / Entitlements

Proof boundary

Codex dry-run passed / 6/6 tests passed

Build scope

Included, required from you, and outside the claim.

Included
  • Stripe checkout flow
  • Subscription and trial handling
  • Customer portal entry point
  • Verified webhook handler
Bring yourself
  • Stripe account and API keys for live billing
  • Webhook signing secret for production webhooks
  • Product/pricing decisions from the human
Out of scope
  • Webhook signature skipped
  • Frontend state trusted for access
  • Failed payment states ignored
  • Portal exposed without auth
Agent handoff

Start from the packet, not the UI.

agb start https://agent-buildprint.com/buildprints/stripe-billing-extension/package.json
Key files

The first files an agent should read.

All package files
BUILDPRINT.md compatibility bootstrap or package contract
checks/acceptance.md acceptance checklist
CONTRACTS.md legacy interface/data contracts, when present
PLAN.md legacy execution index, when present
proof/package.json offline proof artifact
proof/src/billing/entitlements.ts offline proof artifact
proof/src/billing/env.ts offline proof artifact
proof/src/billing/errors.ts offline proof artifact
proof/src/billing/provider.ts offline proof artifact
proof/src/billing/service.ts offline proof artifact
proof/src/billing/store.ts offline proof artifact
proof/src/billing/types.ts offline proof artifact
proof/src/billing/webhook.ts offline proof artifact
proof/src/billing/webhookVerifier.ts offline proof artifact
proof/src/index.ts offline proof artifact
proof/src/ui/billingUi.ts offline proof artifact
proof/test/billing.test.ts offline proof artifact
proof/test/node-builtins.d.ts offline proof artifact
proof/tsconfig.json offline proof artifact
publication.json machine-readable mirror
README.md human overview, non-authoritative
SPEC.md legacy behavior requirements, when present
TARGET_STACK_ADAPTERS.md Buildprint package file
TEST_MATRIX.md legacy risk-to-test alignment, when present
VALIDATION_TEMPLATE.md legacy completion report template, when present