用途:该技能用于在网站应用(主要是 Next.js)中快速接入 Solvapay 托管结账与客户门户。当用户要求在网页应用中添加托管结账并支持认证与客户门户时使用。
文档来源(按顺序):优先使用 SolvaPay Docs MCP 服务器 https://docs.solvapay.com/mcp;备用索引 https://docs.solvapay.com/llms.txt;以及直接文档页面。若 MCP 不可用,建议将其作为可选方案并继续。
检索提示:先通过 MCP 搜索解析主题,再查 llms.txt。相关主题包括结账会话、客户会话、Next.js 指南、React 指南、webhooks、沙箱测试。
防护约束:当托管结账可用时,绝不自行构建自定义卡片表单;绝不在客户端代码中暴露 SOLVAPAY_SECRET_KEY;结账会话创建必须留在服务端;面向用户的文本始终使用 Solvapay 命名;从结账返回后始终以服务端真实状态校验访问权限。
技术栈支持:Next.js 完全支持(nextjs/guide.md);React(非 Next.js)提供部分指引(react/guide.md)。对于 API 密集或非网站场景,转至 ../integrate-solvapay-sdk/SKILL.md。
任务进度:确认框架与认证策略;实现服务端结账会话路由;实现客户门户会话路由;用订阅状态为高级视图加门控;在沙箱中端到端验证托管结账。
交付输出:完成后提供所用框架与认证模型;已实现的结账/客户会话/订阅检查路由;返回 URL 行为与结账后刷新路径;沙箱验证结果(成功与失败用例)。
限制:官方文档正文未提供,具体代码示例、环境变量配置细节与定价信息暂未提供。