SuperAPI AI 工具集

iblai-vibe-monetization-onboard

通用与其它

查看项目

更新于 10-15 22:16

技能介绍

用途:在 Platform 的 Monetization 标签页中构建 Stripe Connect Express 入驻界面。在 is_ready_for_payments 变为 true 之前,后续所有付费墙、价格层级与结账都无法扣款。

主要能力:SDK 组件 StripeConnect(来自 @iblai/iblai-js)自动渲染状态卡片,含三种状态——Ready(Configured 蓝色徽章,按钮 Stripe Dashboard)、Started but incomplete(Incomplete 黄色,按钮 Complete Setup)、Not started(Not Configured 灰色,按钮 Configure Stripe)。徽章与按钮文案由 SDK 提供,不应改样式;徽章映射 is_ready_for_payments / has_account,而非 onboarding_complete。卡片在状态响应 is_owner: true 时自动挂载于 MonetizationTab 内。

使用方式:前置条件包括先完成 /iblai-vibe-auth 的鉴权、配置 .mcp.json 与 @iblai/mcp、安装技能 npx skills add iblai/vibe --all、iblai.env 含 PLATFORM、DOMAIN、TOKEN,Account 页面已存在,调用者具 IsPlatformAdmin 角色,且 currentTenant 的 enable_monetization === true。五个 Connect 端点均位于 DM 服务({dm_url},如 https://api.iblai.app/dm),需 Authorization: Token <DM token>(非 AXD token):GET .../stripe/connect/status/、POST .../stripe/connect/onboard/、POST .../stripe/connect/onboard/refresh/、GET .../stripe/connect/dashboard/、DELETE .../stripe/connect/。调用前应抓取 {dm_url}/api/docs/schema/ 的实时 OpenAPI schema 核对路径、方法与请求响应结构。

限制:Connect 端点仅限 Platform 所有者,非所有者返回 403 且 is_owner: false,卡片隐藏。SDK 卡片硬编码 business_type: 'company',如需 individual 需自建界面。dashboard URL 为一次性,需点击时获取。DELETE 为软删除,付费墙配置保留但无法扣款。常见错误包括误用 has_account 判断、剥离返回 URL 查询参数、iframe 打开入驻链接等。