Integrate Website Checkout

Implement hosted checkout for web apps with minimal PCI surface.

Purpose

Use this skill when the user wants hosted checkout + customer portal quickly in a website app.

Documentation Sources

Use this order:

• SolvaPay Docs MCP server: https://docs.solvapay.com/mcp

• Fallback index: https://docs.solvapay.com/llms.txt

• Direct docs pages

If MCP is unavailable, suggest it as optional and continue.

Docs Discovery Hints

• Topics: checkout sessions , customer sessions , nextjs guide , react guide , webhooks , test in sandbox .

• Retrieval hint: resolve topics via MCP search first, then llms.txt .

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 use Solvapay naming in user-facing text.

• Always verify access state from server truth after returning from checkout.

Stack Support

• Next.js: fully supported -> nextjs/guide.md

• React (no Next.js): partial guidance -> react/guide.md

For API-heavy or non-website use cases, route to ../integrate-solvapay-sdk/SKILL.md.

Handoff Output

When complete, provide:

• framework and auth model used

• implemented routes for checkout/customer session/subscription check

• return URL behavior and post-checkout refresh path

• sandbox validation outcome (success + failure case)

Task Progress

• Confirm framework and auth strategy

• Implement server checkout session route

• Implement customer portal session route

• Gate premium views with subscription state

• Validate end-to-end hosted checkout in sandbox