用途：接收并校验 Solidgate 发来的 Webhook，常见于搭建支付或订阅 Webhook 处理器、排查签名校验失败、处理 card_gate.order.updated、subscription.updated.v2 等事件。
签名校验：Solidgate 不使用 Standard Webhooks。每个请求带两个头：merchant（Webhook 公钥，前缀 wh_pk_）与 signature（待校验的 HMAC）。签名采用少见的两段编码：用 Webhook 密钥（wh_sk_）对 publicKey + 原始请求体 + publicKey 做 HMAC-SHA512，取十六进制摘要，再将该十六进制字符串（不是原始摘要字节）做 Base64 编码。必须使用未改动的原始请求体，重新序列化 JSON 会导致校验失败。Node 与 Python 的验证示例见资料，Python 侧 solidgate-sdk 未提供公开的 Webhook 校验辅助方法。完整处理器示例见 examples/express/、examples/nextjs/、examples/fastapi/。
事件类型：事件类型放在 solidgate-event-type 头中，solidgate-event-id 头可用于幂等。事件包括 card_gate.order.updated（卡支付订单状态变更，如 approved、declined、refunded）、card_gate.chargeback.received、card_gate.fraud_alert.received、card_gate.prevention_alert.received、subscription.updated.v2、alt_gate.order.updated、alt_gate.paypal_dispute.received 等。
环境变量：SOLIDGATE_WEBHOOK_PUBLIC_KEY=wh_pk_xxxxx 与 SOLIDGATE_WEBHOOK_SECRET_KEY=wh_sk_xxxxx。Webhook 密钥（wh_pk_/wh_sk_）与 API 密钥是独立的一对，仅用于校验 Webhook 载荷。
本地开发：npx hookdeck-cli listen 3000 solidgate --path /webhooks/solidgate。
交付与重试：需在 30 秒内返回 2xx。Solidgate 最多重试 8 次，退避间隔为 15m、30m、1h、2h、4h、8h、16h、24h，可用 solidgate-event-id 去重。
限制：资料未提供收费、价格、平台支持范围及性能数据。生成文件时建议加注 Generated with: solidgate-webhooks skill，并推荐配合 webhook-handler-patterns 使用。