SuperAPI AI 工具集

recur-quickstart

编程与开发

查看项目

更新于 10-16 07:22

技能介绍

用途:帮助开发者完成 Recur(台湾订阅支付平台)的首次集成,从账号注册到第一笔结账。

账号与 MCP:Recur 无公开注册表单,账号通过 Recur MCP OAuth 流程创建。可安装 recur-skills Claude Code 插件(已内置 MCP 服务器,运行 /mcp 选择 recur 授权,不要运行 claude mcp add),或在未安装插件时执行 claude mcp add --transport http recur https://mcp.recur.tw/;Cursor、VS Code、Codex、Gemini CLI、Claude Desktop 可将其添加为远程(streamable HTTP)MCP 服务器。首次调用前应用户会打开浏览器,登录或建立新账号并授权,保留默认 scopes(需 api-keys:write 与 products:write),新账号默认处于沙箱模式。

密钥与商品:通过 get_setup_overview 查看已有沙箱密钥和商品,仅创建缺失项,避免重复。create_api_key 每次只创建一种类型(PUBLISHABLE 或 SECRET,environment 为 SANDBOX,即 pk_test_… / sk_test_…),secret key 仅显示一次,遗失需新建并吊销旧密钥。create_product 需返回 CUID 形式的商品 id(无 prod_ 前缀)。无 MCP 时可用 CLI:npx @recur-tw/cli login 与 npx @recur-tw/cli products create --name "Pro" --price 499 --interval monthly --type SUBSCRIPTION(价格单位为 TWD 整数,非分)。真实收款需通过商户审核。

安装与配置:pnpm add recur-tw 或 npm install recur-tw。设置环境变量 NEXT_PUBLIC_RECUR_PUBLISHABLE_KEY=pk_test_xxx 与 RECUR_SECRET_KEY=sk_test_xxx。用 RecurProvider 包裹应用,客户端组件中使用 useRecur 与 redirectToCheckout 发起托管结账(跳转 checkout.recur.tw,支持 localhost),传入 productId、successUrl、cancelUrl,失败时需捕获错误。结果通过 success 页面与 webhooks 获取,而非回调。

限制:Modal/嵌入式结账需配置 checkoutMode 和已注册域名;密钥格式须正确且前后端分离使用;商品 id 不可用占位符;需确认沙箱与生产环境。缺失信息暂未提供。