用途:帮助后端正确接收并处理 RevenueCat Webhook。RevenueCat 对所有商店推送统一的 JSON 事件结构,服务端需验证签名、按 event.id 去重,并按事件类型分发。
主要能力:覆盖事件外层结构(api_version 与 event 对象,含 id、type、app_user_id、product_id、period_type、purchased_at_ms、expiration_at_ms、store、environment、entitlement_ids、transaction_id);给出事件类型与处理动作对照,包括 INITIAL_PURCHASE、RENEWAL、CANCELLATION、UNCANCELLATION、EXPIRATION、BILLING_ISSUE、PRODUCT_CHANGE、SUBSCRIBER_ALIAS、TRANSFER。
关键规则:CANCELLATION 只是关闭自动续订的意图信号,不应立即撤销,应在 expiration_at_ms 安排撤销;EXPIRATION 才真正撤销;过期后重新订阅会触发 RENEWAL 而非 INITIAL_PURCHASE,因此 RENEWAL 分支必须能授予权益而非仅延长;BILLING_ISSUE 只标记账户,不撤销。
使用方式:需自备 HTTPS POST 端点、RevenueCat 后台 Integrations→Webhooks 的 webhook secret,以及可持久化记录已处理事件 ID 和按 app_user_id 记录权益状态的存储。处理流程为验证 X-RevenueCat-Signature、解析事件、以 event.id 原子去重、按类型分发,并尽快返回 2xx;慢处理应入队后确认,避免重试与重复投递。
限制:资料未提供具体签名算法实现、各语言 SDK 细节、价格或平台支持范围,暂未提供。