Affonso推荐裂变与受众增长

它在解决什么问题

SaaS 产品用 Stripe 或 Paddle 收款已经很顺，但 affiliate 佣金链路常常在别处断开：跨设备转化因为只有 Cookie 像素而悄悄漏掉，同一个订单被重复计入两笔佣金，新签约的推广人迟迟没同步进 HubSpot。这些问题事后很难从一张导出表里看出来。这个技能面向的是要把 Affonso 后台接进真实产品的工程师：它把官方文档整理成完整的对接面——78 个 REST 接口、21 个签名 Webhook 事件、TypeScript SDK、MCP 服务与 CLI——可以在 Claude Code、Cursor 里直接调用，也能在 Zapier、Make、n8n 里编排。

核心能力与工作流程

上下文采集：先确认目标（启动项目、修归因、做集成、选套餐、对比平台或排障）、计费服务商与计划档位；用户提示里已经够全时直接进入下一步。

路由而非硬答：当问题其实是佣金结构、招募策略、结账页优化或漏斗设计时，技能会把控制权交给 /sales-affiliate-program 等相应技能，并给出准确命令，而不是凭空编一套策略。

按需查参考：平台细节写在两份文件里——references/platform-guide.md 负责模块划分、计划门禁、数据模型和快速开始；references/affonso-api-reference.md 负责逐字接口文档。回答时只取相关段落，不做全文倾倒。

可执行的工程建议：转化记录要求传入 external_event_id，它必须是支付服务商自己的稳定 ID（如 Stripe 的 evt_…），不能每次临时生成 UUID；重复佣金只能用 POST /v1/conversions/{id}/refund 冲销，不删记录；Webhook 用事件驱动而不是轮询，快速返回 2xx、异步处理、按 event.id 去重；X-RateLimit-* 头不可靠，回退到固定退避。

适用边界与注意点

Launch 档即可使用 REST API、Webhooks、SDK 与 CLI，MCP 服务需 Growth 及以上；该门槛与价格属于基于研究的 best-effort，需以官网为准。sale_amount 是主单位，Stripe 返回的分要先除以 100。价格用欧元报价，佣金上限却用美元计价，临近封顶的账户要留汇率余量。密钥分层：像素与嵌入 token 在前端，sk_live_… 只在服务端，Webhook 签名密钥是每端点独有的 whsec_…，且必须对原始请求体验签，express.json() 解析后再验会因字节变化而失败。平台没有原生 HubSpot/Salesforce 连接器，也没有自助 SSO，集成只能走 Webhooks 加 Zapier/Make/n8n；partnershipStatus 可能为 null，分支里必须有判空。