Website Checkout

Add SolvaPay hosted checkout and customer portal to a web app with minimal PCI surface. Use when the user says "add checkout to website", "hosted checkout", "customer portal", "nextjs checkout", "checkout session", or wants a server-side checkout-session route plus a return-URL handler. Next.js is fully supported; React (no Next.js) gets partial guidance. Use the `sdk-integration` skill instead for usage metering, Express, MCP server wiring, or webhook-heavy flows; use `lovable-checkout` for Lovable / Vite / Supabase Edge apps.

solvapay 38347b7 11 files · 19.9 KB Updated

File contents

Website Checkout

Hosted checkout + customer portal for web apps. Server creates the checkout session, browser redirects to SolvaPay, return URL handler refreshes access state from server truth.

Quick Start

  1. Read guide.md — stack detection, guardrails, handoff output.
  2. Run npx -y solvapay@latest init to configure SOLVAPAY_SECRET_KEY and install base SDK packages.
  3. Follow the matching stack guide:
    • nextjs/guide.md — fully supported
    • react/guide.md — partial guidance (you still need a backend)

For advanced flows (usage metering, Express, MCP, custom webhooks) use the sdk-integration skill instead.

Guardrails

  • Never build custom card forms when hosted checkout is acceptable.
  • Never expose SOLVAPAY_SECRET_KEY in client code.
  • Always keep checkout session creation on the server.
  • Always verify access state from server truth after returning from checkout.
  • Always use SolvaPay naming in user-facing text.

solvapay/cursor-plugin/tree/main/plugins/solvapay/skills/website-checkout commit 38347b7352

Frequently asked questions

npx skillmds@latest add solvapay/website-checkout