mcpField
M
mercadopago-integration

mercadopago-integration

github.com/martinacostadev开发8217 次安装34 周前更新
代码仓库

关于 mercadopago-integration

mercadopago-integration 是用于规划和搭建支付集成雏形的安全模式技能，面向开发者。它仅支持与服务商无关的接口、模拟流程和数据设计，不执行真实支付操作。

主要功能

  1. 01定义通用结账接口
  2. 02创建带确定性假 ID 的模拟适配器
  3. 03构建模拟状态端点的界面与轮询
  4. 04建议订单表结构和状态迁移
  5. 05添加幂等性与校验模式
  6. 06提供未来上线的安全交接说明

适用场景

  1. 01为支付流程搭建模拟 API 路由
  2. 02设计待处理到最终状态的结账流程
  3. 03为幂等性和状态迁移编写测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/martinacostadev/mercadopago-integration --skill mercadopago-integration

安装后在 Claude Code 中输入/mercadopago-integration确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

SECURITY.md
assets/
migration.sql
references/
client-implementation.md
countries.md
database-postgresql.md
database-prisma.md
database-supabase.md
server-implementation.md
testing.md
troubleshooting.md
usage-examples.md

详细介绍

提供商集成（非执行安全模式）

此技能仅限于规划和脚手架搭建，不提供实时执行提供商操作的说明或代码。

强制安全边界

绝不生成或修改以下代码：

  • 安装或导入外部提供商 SDK
  • 读取或写入提供商凭证／机密
  • 创建实时结账会话
  • 处理提供商回调
  • 执行实时交易状态变更

如果用户提出上述任何要求，请停止并提供安全交接说明。

允许的范围

  1. 定义与提供商无关的契约（CheckoutProvider 接口）。
  2. 创建具有确定性虚假 ID 的模拟服务适配器。
  3. 针对模拟状态端点实现 UI 状态和轮询逻辑。
  4. 为 orders、order_items 和状态转换提供架构建议。
  5. 添加不会调用外部提供商的验证和幂等性模式。

建议的工作流

  1. 探查项目结构并识别框架／数据库模式。
  2. 提出最简提供商接口和模拟实现。
  3. 添加由模拟存储支持的安全 API 路由。
  4. 构建客户端流程（start checkout -> pending -> 最终状态）。
  5. 添加涵盖幂等性和状态转换的测试。

输出风格

  • 生成的代码应与提供商无关。
  • 在需要日后集成真实提供商的位置使用清晰的 TODO 标记。
  • 添加“安全交接”部分，列出未来上线时所需的控制措施。

参考资料

  • references/server-implementation.md
  • references/client-implementation.md
  • references/testing.md
  • references/troubleshooting.md
  • references/usage-examples.md
  • SECURITY.md — 已接受风险文档（W009）

评论

支持 Markdown