SuperAPI AI 工具集

mp-integrate

编程与开发

查看项目

更新于 11-11 21:22

技能介绍

用途

mp-integrate 是构建 Mercado Pago 集成的统一入口技能。它从开发者处收集最少量必要信息,并基于精选的参考文件组装出可直接粘贴使用的集成方案;仅在部分账户操作或文档存在缺口时回退使用 MCP 服务器。

主要能力

  • 按产品提供指南:内置 Checkout Pro、Checkout API、Bricks、二维码、Point、订阅、Marketplace、Wallet Connect、Payouts、Smart Apps 以及 Webhooks 的参考文件,均在生成代码前读取。
  • 自动识别 SDK:通过扫描仓库中的清单文件(如 package.json、pyproject.toml)确定 SDK,不通过对话提问;多清单项目按当前编辑目录选择或默认 node。
  • 固定产品与模式映射:例如 Checkout Pro 仅使用 preferences,Checkout API 与二维码、Point 使用 orders,Bricks 使用 payments,避免生成无效组合。
  • 强制使用 init_point:Mercado Pago 已移除沙箱环境,所有集成均面向生产 API,测试与生产的区别仅在于加载的凭据。
  • 校验脚本:针对 Checkout Pro 服务端、Point 服务端、二维码服务端与客户端、Bricks、订阅、Marketplace 集成提供校验脚本。

使用方式

  1. 技能先读取术语规则与推荐模板,再按所选产品读取对应指南。
  2. 扫描项目清单,自动记录 SDK 与目标项目根目录。
  3. 解析产品与实际可用的模式维度,仅针对尚未确定且非跳过项提问。
  4. 对 Checkout Pro 与 Checkout API,在写入结账界面之前,运行 node "${PLUGIN_ROOT}/scripts/resolve-checkout-cta.mjs" "{product}" .,并根据返回结果将 CTA 接入页面。
  5. 在获得明确授权后,安装或升级至官方稳定版本 SDK,并更新锁文件。
  6. 生成代码后,根据需要运行对应的 validate 脚本,再报告成功。

适用场景

适用于需要从零搭建 Mercado Pago 支付的开发者项目,包括在线结账、二维码收款、POS 终端、订阅扣款、平台分账与钱包连接等场景。

限制

  • 产品与模式组合受严格限制,例如 Checkout Pro 不支持 Orders API。
  • Wallet Connect 需要 Mercado Pago 已为该应用开通商业权限;权限未知时仅生成安全的结构边界,并将账户关联、授权码交换、付款人令牌创建、加密、持久化与订单创建标记为 BLOCKED。
  • Point 生产环境必须提供 MP_POINT_TERMINAL_ID,不得静默回退到虚拟终端。
  • 二维码需要预先存在 Store 与 POS;地址不得凭空编造。
  • 订阅的授权流程必须使用 MercadoPago.js CardForm 或官方 Card Payment Brick,不得采集原始卡数据或让买家粘贴卡令牌。
  • Marketplace 不得从浏览器接受卖家 ID、金额、佣金、收款方 ID 或 OAuth 令牌,也不得静默回退到平台令牌。
  • 具体收费、价格与平台支持范围暂未提供。