用途：帮助人类用户完成 Portaly Payment API 集成，回答以可操作步骤、请求/响应要点和可复制示例为主，而非长篇架构说明。
主要能力：创建商户配置、创建订阅计划（月付、年付含 12 个月递延拨付）、上传商户或计划图片、创建结账会话、处理并验签回调；如需订阅生命周期管理，可接入取消与恢复 API；如需订阅者自助，可接入 portal session API。
环境与模式：API host 与结账站点统一为 https://portaly.ai，可用 PORTALY_API_HOST 环境变量覆盖，推荐写法 const PORTALY_API_HOST = process.env.PORTALY_API_HOST || 'https://portaly.ai'。live 键前缀 pcs_live_，走 91APP 跳转并在回调完成；test 键前缀 pcs_test_，走 TapPay 沙箱在结账页直接扣款。模式在创建 API key 时确定，之后不可更改；同一 profileId 可同时持有 live 与 test 键。除退款 POST /orders/{orderId}/refund 需 live 全范围键外，端点均接受两种键。计划与商户配置按 profileId 共享，切换模式时先用 GET /api/creator-subscription/plans 查询并复用，勿重复创建。
使用前提：需先注册 Portaly Payment 账户，并在 https://portaly.cc/admin/creator-subscription 创建 API key 与 CallbackSecret。live 键需同时满足：通过金流審核/KYC（否则 403 PAYMENT_KYC_NOT_VERIFIED）、持有付费会员（否则 403 PREMIUM_REQUIRED）、从第二个产品起该产品自身通过审核（否则 403 PRODUCT_REVIEW_NOT_VERIFIED）。建议先用 test 键联调；test 订阅不会续订，退款不发送 payment.refunded。
密钥与安全：不要让用户把 API key 或 callbackSecret 粘贴到聊天中；用户应自行写入 .env（PORTALY_API_KEY、PORTALY_CALLBACK_SECRET），并确保 .gitignore 含 .env。若误粘贴，建议在仪表盘轮换密钥。回调验签先确认仓库语言与框架，参照 callback-signature-v1.md 并运行对应适配器的向量，未列出的运行时用服务端桥接或暂缓。
报告版本：安装后或首次真实调用 Portaly API 时（以先到者为准，且环境已有 PORTALY_API_KEY）发送一次 POST https://portaly.ai/api/creator-subscription/skill-version，Authorization: Bearer {PORTALY_API_KEY}，body 为 {"skillName":"portaly-payment","version":"0.18.1"}，version 取当前 SKILL.md 的 metadata.version。失败可忽略，不阻塞流程；响应中的 data.available 仅作可选推荐，需自行按本地项目过滤后再提示。
限制：资料未提供价格、平台、效果等信息；不得编造测试卡号，test 结账页会高亮显示可用测试卡。测试订单不进入结算链，不产生收入、余额、打款、佣金、发票与评价邀请。