Skip to content

docs: add framework integration guides for Next.js, Express, Node.js and Python - #1131

Draft
juandolealt wants to merge 1 commit into
mainfrom
docs/framework-integration-guides
Draft

juandolealt wants to merge 1 commit into
mainfrom
docs/framework-integration-guides

Conversation

@juandolealt

Copy link
Copy Markdown
Member

Adds five short, copy-paste integration guides, one setup per page, for developers and coding agents looking for framework-specific answers:

  • Accept stablecoin payments in Next.js (/docs/resources/guides/accept-stablecoin-payments-nextjs)
  • Charge for an API with MPP in Express (/docs/resources/guides/charge-for-an-api-express)
  • Charge for an API route with MPP in Next.js (/docs/resources/guides/charge-for-an-api-nextjs)
  • Send stablecoin payouts with Node.js (/docs/resources/guides/stablecoin-payouts-nodejs)
  • Send stablecoin payouts with Python (/docs/resources/guides/stablecoin-payouts-python)

Navigation: the pages stay out of the sidebar. Each one is a supporting page, linked from a new short section in its parent workflow guide (Plan stablecoin payment acceptance, HTTP 402 Payment Required, Plan global payouts) and registered in supportingPages in sidebar-coverage.test.ts. They still export as Markdown and appear in llms.txt.

Next.js + mppx fix: mppx@0.13.3 needs Next.js >= 16.2.6. Under Turbopack, mppx/nextjs routes fail with Can't resolve '@modelcontextprotocol/sdk/types.js' unless serverExternalPackages: ['mppx'] is set. The Next.js MPP guide covers this, and this PR adds a warning to the existing Accept payments for an API page.

Verification: every code sample ran end to end on Moderato with faucet-funded accounts:

  • Express and Next.js (16.4.6) MPP routes return a 402 challenge, a mppx/client payer pays 0.01 OUSD, and the response returns 200 with a success receipt.
  • The Next.js invoice flow creates an invoice, pays it with transferSync and a memo, and the verify route marks it paid with an event key.
  • The Node.js (viem 2.57.5) and Python (pytempo 0.6.1) payout scripts sent CSV batches with memos. Transfers to new addresses use about 280k to 350k gas each, so the Python script estimates gas instead of hardcoding it.

Checks: pnpm test (1687 passed), pnpm check:anchors, pnpm build, pnpm check:markdown (340 pages).

@vercel

vercel Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
tempo-docs Ready Ready Preview Nov 12, 2026 2:29pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — e0372f0d Deployed Nov 12, 2026 by vercel[bot]
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