用途：为 Portaly Payment 商品开启买家推广。买家完成购买后会拿到自己的推荐链接，他人经该链接购买时买家获得佣金。该技能是“开关+归因”，不是佣金引擎；推荐链接、账本、退款追回、结算时间与提现均由 Portaly 负责（收益页 https://rewards.portaly.cc），创作者代码只需记住买家进入时的推荐链接并在创建结账会话时传出。
主要能力：读取并设置商品级推广开关与统一佣金率（无按方案单独费率）；读取各方案是否符合条件、设置每个方案自己的落地页 promotionUrl；开启推广。环境方面，API 主机可用 PORTALY_API_HOST 覆盖（默认 https://portaly.ai），密钥前缀 pcs_live_ / pcs_test_；测试模式不会产生真实或模拟佣金，因为测试购买写入沙盒订单集合，结算链不读取。
必要用法：需已有可用的 Portaly Payment 环境（API 密钥与至少一个启用中的一次性固定价方案），从 .env/process.env 读取 PORTALY_API_KEY，勿让用户粘贴到聊天，确认 .gitignore 覆盖 .env，建议先用 pcs_test_。必须使用全权限密钥，集成范围密钥（pcs_test_itg_* / pcs_live_itg_*）在写操作时返回 403 KEY_SCOPE_FORBIDDEN。限流为读 120/分钟、写 20/分钟，写操作每方案一次加开关一次，方案较多易触发 429，应按 Retry-After 分批并事后重新读取确认。设置落地页：PUT {PORTALY_API_HOST}/api/creator-subscription/plans/{planId}，请求体 {"promotionUrl":"..."}；开启推广：PUT {PORTALY_API_HOST}/api/creator-subscription/promotion}，请求体 {"enabled":true,"commissionRate":20}，费率须为整数。会话内可上报技能版本：POST https://portaly.ai/api/creator-subscription/skill-version，带 Bearer 密钥。
限制：仅一次性、固定价且非免费的有效方案可参与，订阅方案与动态定价方案不支持；仅限台湾账号，提现走台湾银行账户；整个商品一个费率，不支持按方案设置，也不承诺未来支持；佣金基数受折扣码影响，需先核对可用折扣码再发布金额。落地页须为线上生产地址，Portaly 会拒绝 http、localhost、IP、无点主机名、保留后缀及带凭据的 URL。