SuperAPI AI 工具集

lithic-webhooks

测试与质量

查看项目

更新于 10-16 05:52

技能介绍

用途:Lithic 通过 Webhook 向你的端点推送事件(卡片发行、交易、争议、资金流转等),采用 Standard Webhooks 规范(由 Svix 支持)。本技能用于接收、验证 Lithic Webhook 并处理事件。

主要能力:签名校验采用 HMAC-SHA256,签名内容为 {webhook-id}.{webhook-timestamp}.{rawBody},每个订阅有独立签名密钥(前缀 whsec_)。请求头为 webhook-id、webhook-timestamp、webhook-signature(Svix 另发 svix-* 别名),签名头为空格分隔的 v1,<base64sig>,时间戳容差约 5 分钟。

使用方式:官方 SDK 单次调用即可验证并解析事件——webhooks.unwrap(rawBody, headers, secret),会强制时间戳容差并在失败时抛出异常,必须传入原始请求体。 Python 验证需可选包:pip install "lithic[webhooks]"。 本地开发可用 Hookdeck CLI:npx hookdeck-cli listen 3000 lithic --path /webhooks/lithic

环境变量:LITHIC_WEBHOOK_SECRET=whsec_xxxxx(来自 Lithic Dashboard),LITHIC_API_KEY=your_api_key(仅调用 Lithic API 时需要)。

常见事件:card.created、card.updated、card_transaction.updated、payment_transaction.created、payment_transaction.updated、dispute.updated、balance.updated、three_ds_authentication.created 等,事件字段为 resource.action 形式。

适用场景:搭建 Lithic 事件订阅、调试签名验证失败、处理卡片与支付交易事件。

限制:完整处理程序与测试见示例目录,事件全表见参考资料;签名验证失败或时间戳过期应返回 400。其他细节资料未提供。