mcpField
S
sumup-best-practices

sumup-best-practices

github.com/sumup开发560 次安装3 周前更新
代码仓库

关于 sumup-best-practices

为 AI Agent 提供 SumUp 集成架构与安全决策指导，面向需要选择终端或线上支付方案的开发者。它帮助比较集成路径、认证方式和运行约束，不提供实现步骤。

主要功能

  1. 01按终端、线上或混合场景分类
  2. 02选择适用的 SumUp 集成路径
  3. 03比较 API key 与 OAuth 认证
  4. 04检查支付安全和运营约束
  5. 05要求给出风险与验证计划

适用场景

  1. 01为线下刷卡或线上支付选择方案
  2. 02确定单商户或多商户认证模式
  3. 03评估 Webhook 重试与幂等处理
  4. 04规划支付上线前的验证

安装

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

$npx skills add https://github.com/sumup/sumup-skills --skill sumup-best-practices

安装后在 Claude Code 中输入/sumup-best-practices确认已加载。

附带文件agents/openai.yamlassets/small-logo.svg

详细介绍

SumUp 集成决策与最佳实践

知识和 API 可能会发生变化。始终优先参考最新的 SumUp Markdown 格式文档，而不是过时的记忆。

  • 文档根目录：https://developer.sumup.com/
  • LLM 入口：https://developer.sumup.com/llms.txt

将此技能用于架构和安全决策，而非实现步骤讲解。

快速决策树

Need to accept a payment?
├─ In-person (card-present)
│  ├─ Native mobile app controls reader directly -> iOS Terminal SDK / Android Reader SDK
│  ├─ POS/backend controls Solo from non-native environment -> Cloud API
│  └─ Legacy handoff to SumUp app is mandatory -> Payment Switch
└─ Online (card-not-present)
   ├─ Fastest redirect flow, no embed required -> Hosted Checkout
   ├─ Embedded payment form with low PCI scope -> Card Widget
   ├─ Mobile app checkout UX -> Swift Checkout SDK / React Native SDK
   ├─ Save card and charge later -> Customers + tokenization
   └─ Custom orchestration needs -> Checkouts API + 3DS + webhooks

从这里开始

  1. 对请求进行分类：terminal、online 或 hybrid。
  2. 优先选择复杂度最低且可行的方案：
    • 优先选择 Hosted Checkout 或 Card Widget，而非自定义编排。
    • 对非原生 Solo 控制，优先选择 Cloud API。
  3. 选择身份验证模式：
    • 单商户服务端集成使用 API key。
    • 委托式或多商户应用使用 OAuth 2.0。
  4. 确认受限访问权限和联盟方的前置条件：
    • 在需要时激活 payments scope。
    • 对银行卡现场支付，确保 Affiliate Key 与应用／Bundle 标识符一致。
  5. 确认运营约束：
    • 币种与商户匹配
    • Webhook 端点就绪且具备幂等性
    • 兼容旧版的要求

不可妥协的规则

  • 仅在服务端保存 API 密钥和 OAuth 密钥。
  • 绝不直接处理原始 PAN／银行卡详细信息。
  • 通过服务端到服务端的方式创建在线结账。
  • 优先使用托管式／Widget／SDK 结账界面，而非自定义银行卡处理。
  • 避免使用已弃用的端点。
  • 使用唯一的交易引用（checkout_reference、foreignTransactionId 或同等字段）。
  • 将 Webhook 回调视为信号；履行订单前通过 API 验证最终状态。
  • 假设请求会重试且消息会重复投递；确保后端处理具备幂等性。

必需的响应规范

提供指导时，始终返回：

  1. 所选集成方案及简要原因。
  2. 凭证模式建议（API key 或 OAuth）及所需 scope。
  3. 针对所选方案的安全检查清单。
  4. 风险／权衡，以及何时应选择其他方案。
  5. 上线前的最低验证计划。

移交给实现技能

  • 使用 sumup 获取端到端实现步骤。
  • 使用 upgrade-sumup 进行 SDK／API 迁移。
  • 使用 sumup-debug 诊断故障。
  • 使用 sumup-testing 设置 Sandbox 和 QA。

评论

支持 Markdown