用途:帮助开发者搭建 Tebex Webhook 处理程序,调试 X-Signature 验证失败,完成 validation.webhook 握手以激活端点,并处理支付、争议与订阅类事件。
主要能力:Tebex 无官方 SDK,需手动验证十六进制 X-Signature 头。签名分两步:先对原始请求体做 SHA-256 哈希,再用 webhook secret 作为密钥对该十六进制哈希做 HMAC-SHA256。验证前不要 JSON.parse,重新序列化的请求体会产生不同哈希。资料给出 Node 与 Python 的验证函数示例。
握手:配置时 Tebex 发送 validation.webhook ping,验证签名后需返回 200 并回显收到的 id,即 {"id": "<payload.id>"},否则端点不会激活。
事件类型:validation.webhook、payment.completed、payment.declined、payment.refunded、payment.dispute.opened/won/lost/closed、recurring-payment.started/renewed/ended/cancellation.requested/cancellation.aborted。载荷统一信封包含 id、type、date、subject。
使用方式:环境变量 TEBEX_WEBHOOK_SECRET 取自 Creator Panel > Developers > Webhooks > Endpoints。Tebex 仅从 18.209.80.3 和 54.87.231.232 发送 Webhook,文档建议对其他 IP 返回 404。本地开发可用 npx hookdeck-cli listen 3000 tebex --path /webhooks/tebex 启动隧道。完整处理器示例见 examples/express/、examples/nextjs/、examples/fastapi/。
限制与建议:资料未提供收费、价格或平台支持范围等信息。建议配合 webhook-handler-patterns 技能处理顺序、幂等、错误处理与重试逻辑。