用途:为已建好的网站或建站器站点附加购物车与结账能力,网站保留商品页,Foxy 托管购物车、结账和收据。适合 Webflow 等原生电商不够用、需要更多支付网关、订阅、捐赠或可配置商品的场景。
主要能力:商品以加入购物车链接/表单形式定义,并用 HMAC 签名保护;自动化通过超媒体 REST API(hAPI,OAuth 2.0)和 HMAC 签名 webhook 完成,webhook 具备重试语义;购物车/结账/收据通过模板集自定义样式。
使用方式:链接/表单签名必须在构建期或服务端完成,可用官方 SDK(@foxy.io/sdk 的 Signer)或部署预构建的无服务器签名函数,切勿将商店密钥放入浏览器。webhook 需对原始请求体做 HMAC-SHA256(十六进制),密钥为 webhook 加密密钥,恒定时间比较 Foxy-Webhook-Signature,并在 1 分钟内返回 200。调用 hAPI 应遵循链接关系而非硬编码 URL,使用 zoom 嵌入关联数据。
限制与注意:未签名链接的价格可被篡改,HMAC 校验是安全模型,不可选。连续 12 次 webhook 投递失败会自动停用该 webhook,需监控停用并通过后台 refeed 回放遗漏事件(refeed 请求带 Foxy-Webhook-Refeed: true)。购物车、结账和收据为 Foxy 托管页面,不会继承站点样式,需单独做模板样式工作,并会多一个管理后台。Foxy 不是 Merchant of Record,税费义务由用户承担。定价与后台状态等资料标注为尽力核实(2026-07),具体以 foxy.io/pricing 为准;部分事实暂未提供。