SuperAPI AI 工具集

mp-webhooks

编程与开发

查看项目

更新于 10-16 00:29

技能介绍

用途:mp-webhooks 专注于 Mercado Pago 通知(Webhook)的配置、签名校验与投递诊断,是 HMAC 校验模式的唯一存放处,其他技能均引用此处。

主要能力:提供接收端 HMAC-SHA256 签名校验模式;通过 MCP 工具 save_webhook 注册或轮换回调 URL,通过 notifications_history 确认或诊断投递;可查询语言相关签名示例与未知主题。

使用方式:脚手架与代码审查为静态操作,无需连接 MCP。仅在执行 MCP 操作前按需连接:先直接调用目标工具,若不可用或返回认证错误,再调用 mcp__plugin_mercadopago_mcp__authenticate,展示可点击 OAuth 链接并提示 Cmd/Ctrl+Click,返回后重试。配置前需准备开发者账号、应用、测试凭据(APP_USR- access token 与 public key)及签名密钥。接收端须读取 x-signature 与 x-request-id,解析 ts、v1,用规范串 id:<data.id>;request-id:<x-request-id>;ts:<ts>; 计算 HMAC-SHA256 并常量时间比较,校验通过立即返回 200 后异步处理,且需幂等(以 data.id + topic 去重)。

适用场景:首次配置或轮换 Webhook 端点、排查漏发/失败通知、为代码库添加接收端。

限制:不搭建周边集成(用 mp-integrate),不评估质量(用 mp-review),不凭记忆编造主题名;simulate_webhook 已不存在,需用真实测试支付验证;IPN 旧式通知已弃用。非 200 响应会以指数退避重试约 24 小时。