SuperAPI AI 工具集

paddle-onboarding

部署与运维

查看项目

更新于 10-22 22:19

技能介绍

这是一个用于检查 Paddle 账户上线(go-live)就绪状态的 AI 技能。当用户想知道账户是否可以上线、还差什么配置、为什么还不能接收正式付款,或计划把集成从沙盒切换到正式环境时使用。它通过 Paddle API 审计账户状态,而不是检查代码;代码侧的待办项(如正式环境 ID、api.paddle.com、移除沙盒环境、传递 pwCustomer、放行 Paddle IP 等)API 不可见,若代码库开放可一并核对,否则标记为「无法判断」。

主要能力:审计前需要先选择环境,沙盒与正式完全独立;先只读完成全部审计并报告,再逐项提出修复。审计项包括 API 访问、账户详情、产品目录(至少一个活跃产品带活跃价格)、客户端 token、默认支付链接、支付方式、销售税、结算货币、通知目的地、网站审批(仅正式)、账户验证(仅正式)。每项通过一次 API 读取完成,需用 try/catch 包裹以免单项权限缺失中断整体审计。列表结果数组与 pagination 并列,按资源名(kebab-case)取用,分页用 after 游标。正式环境 OAuth 初始只读,写入需权限。每次 execute 上限 50 次 API 调用、30 秒超时、32000 字符代码。

使用方式:优先使用 Paddle MCP 服务器的 search 与 execute 工具;没有 MCP 时,用用户环境中的 PADDLE_API_KEY 给出 curl 命令(用 jq 删除 endpoint_secret_key),不可让用户把密钥贴进聊天;两者都不可用时,引导用户对照清单在仪表盘手动检查。报告按清单步骤分组,每项状态为已完成、缺失或无法判断,并附对应清单锚点链接,最后给出下一步。修复时逐项说明操作、当前值与建议值,等用户明确同意后再写入,正式环境需明确说明即将修改正式账户;税务模式、结算货币、支付方式等业务决策交由用户选择,不代为决定。

适用场景:上线前自检、沙盒转正式前的配置核对、排查无法收款原因。限制:需要相应读权限;验证状态需为 completed 才代表可上线;2024 年 4 月前创建的账户可能没有 onboarding 验证,应报告无法判断;空列表不可当作已验证或未验证;网站审批状态包含 pending_review、in_review、action_required、approved、rejected;无法通过 API 获知的信息(如提现)标记为无法判断并请用户在仪表盘确认。