用途
该技能专注于 SumUp 支付集成的架构与安全决策，而非实现步骤的逐步讲解。当需要在多种集成方案之间做选择，或需要确认安全最佳实践时使用。
主要能力
- 提供快速决策树，区分线下（card-present）与线上（card-not-present）支付场景。
- 线下场景：原生移动应用直接控制读卡器可选 iOS Terminal SDK / Android Reader SDK；POS 或后端在非原生环境控制 Solo 可选 Cloud API；必须交接给 SumUp 应用时可选 Payment Switch。
- 线上场景：最快重定向且无需嵌入可选 Hosted Checkout；低 PCI 范围的嵌入式支付表单可选 Card Widget；移动应用结账体验可选 Swift Checkout SDK / React Native SDK；保存卡后稍后扣款可选 Customers + tokenization；需要自定义编排可选 Checkouts API + 3DS + webhooks。
- 指导认证模型选择：单商户服务端集成使用 API key，委托或多商户应用使用 OAuth 2.0。
- 确认受限访问与联盟前置条件，包括 payments scope 激活、Affiliate Key 以及应用/包标识符对齐。
- 确认运营约束：货币/商户对齐、webhook 端点就绪与幂等性、遗留兼容性要求。
使用方式
- 分类请求：终端、线上或混合。
- 优先选择最低复杂度的可行路径：优先 Hosted Checkout 或 Card Widget，再考虑自定义编排；非原生 Solo 控制优先 Cloud API。
- 选择认证模型。
- 确认受限访问与联盟前置条件。
- 确认运营约束。
给出指导时，始终返回：所选集成路径及简要理由；凭证模型建议（API key 与 OAuth）及 scope 要求；所选路径的安全态势检查清单；风险/权衡以及何时选择其他路径；生产上线前的最低验证计划。
不可妥协的规则
- API key 与 OAuth 密钥仅保留在服务端。
- 绝不直接处理原始 PAN/卡详情。
- 线上结账通过服务端到服务端创建。
- 优先使用托管/组件/SDK 结账 UI，而非自定义卡处理。
- 避免使用已弃用的端点。
- 使用唯一交易引用（checkout_reference、foreignTransactionId 或等效项）。
- 将 webhook 回调视为信号，在履约前通过 API 验证最终状态。
- 假设存在重试与重复投递，后端强制幂等处理。
适用场景
适用于需要决定 SumUp 支付集成路径、选择认证模型、确认安全与运营约束的架构与安全决策场景。
限制
该技能用于架构与安全决策，不用于实现步骤讲解。实现步骤请使用 sumup；SDK/API 迁移请使用 upgrade-sumup；故障诊断请使用 sumup-debug；沙箱与 QA 设置请使用 sumup-testing。知识与 API 可能变化，应优先使用最新 SumUp 文档（markdown 格式），而非过时记忆。文档根：https://developer.sumup.com/ ；LLM 入口：https://developer.sumup.com/llms.txt 。