用途:在 Account 页面中正确托管 SDK 默认导出的 MonetizationTab,使平台管理员能把已有条目(agent、课程、项目、路径)或自定义条目配置为付费商品,启用付费墙并添加定价档位。
主要能力:Stripe Connect 状态卡;付费墙配置(is_enabled、allow_free_tier、trial_period_days、grandfathering_strategy、on_successful_payment);条目搜索下拉(300ms 防抖,覆盖 agents、courses、programs,另有 + 按钮创建自定义条目);已配置条目分页列表(每页 8 条,可按 All/Active/Disabled 过滤);两步(已有条目)或三步(自定义条目)向导;定价档位 CRUD(名称、金额、interval、features、remark、is_active、sort_order 等)。
使用方式:先完成 /iblai-vibe-auth 认证与 .mcp.json、iblai.env(PLATFORM、DOMAIN、TOKEN)配置;Account 页面已由 /iblai-vibe-account 接好,不要另建宿主。调用 API 前先取 {dm_url}/api/docs/schema/ 校验路径、方法与请求体。付费墙创建需用 composite URL,拿到 unique_id 后改用 canonical URL;价格同理。Account 组件需传入 platformKey 与 authURL,authURL 用于生成 Connect 返回地址与默认支付后跳转。通过 ?profileTab=monetization 直达该面板,路由需保留查询串。
适用场景:平台管理员为已有或自定义商品开通付费墙、管理定价档位,并复制 ${authURL}/buy/{paywallUniqueId} 公开购买链接。
限制:需 Platform 记录 enable_monetization === true(由 ibl.ai 运营方设置,无应用内开关)、can_sell_items RBAC 权限,且 Stripe Connect Express 已完成(is_ready_for_payments: true),否则价格创建返回 400。所有端点要求 IsPlatformAdmin,并使用 DM token(AXD token 返回 401)。canonical 价格详情仅解析启用付费墙上的活跃未删除价格,否则 404。定价字段变更会创建新 Stripe 价格并停用旧价格;删除为软删除。pathway 类型无默认 on_successful_payment,需手动设置。未部署 auth 应用时需自行实现购买页。