upgrade-sumup

用途

upgrade-sumup 是一个面向 SumUp 平台集成方的升级与迁移指南技能。当请求涉及升级、版本提升、弃用处理或迁移时使用。它帮助开发者系统性地完成从旧版本到新版本的过渡，降低因 API 或 SDK 变更导致的集成风险。

支持的升级目标

• Node：@sumup/sdk
• Go：sumup-go
• Python：sumup
• PHP、Java、Rust、.NET SDK/客户端集成
• iOS Terminal SDK
• Android Reader SDK
• Swift Checkout SDK
• React Native SDK
• Checkouts API 及相关 webhook/3DS 端点用法

升级工作流

1. 升级前盘点：记录各服务/应用当前使用的 SDK/库版本、所有用到的 SumUp 端点与字段、认证模式（API key/OAuth）、作用域与 webhook 签名设置，以及受影响的环境（沙箱、预发布、生产）。

2. 破坏性变更差异分析：针对每个 SDK 或端点迁移，对比变更日志与迁移说明，识别重命名/移除的字段、枚举和回调签名，识别异步/支付状态语义的行为变化，识别已弃用端点及必需的替代方案。

3. 迁移实施：一次升级一个层面（先服务端 SDK，再移动端 SDK，最后 UI 集成）。必要时保留兼容适配层，将应用代码与 SDK 变更隔离。用当前等价端点替换已弃用端点，在适用时优先选择接受 merchant_code 的端点。除非必要，保持 webhook 验证与幂等逻辑不变。

4. 升级后验证：在沙箱运行正常路径支付；运行故意失败（金额 = 11）并验证订单状态保持未支付；验证 3DS 跳转/挑战及返回处理；验证 webhook 重试与幂等处理；验证重复引用行为与对账字段。

5. 发布与回滚：分阶段发布（内部 → 低流量 → 全流量）。在可行处添加发布开关。在指标稳定前保留旧版本回滚路径。

迁移检查清单

• 所有已弃用的 SumUp 端点已从活跃代码路径中移除。
• SDK 主/次版本在各服务/应用间一致锁定。
• 任何生成的 API 客户端已重新生成并提交。
• 集成测试已针对新响应结构更新。
• 运行手册已更新新的状态/错误码。
• 监控告警已针对新的故障特征进行审查。

响应契约

每个升级回答应包含：当前状态摘要与目标版本；破坏性变更与受影响的代码层面；最小安全迁移顺序；包含强制失败路径的验证计划；回滚策略与 go/no-go 标准。

适用场景

适用于需要升级 SumUp API 版本、升级服务端或移动端 SDK、处理端点弃用、执行迁移并验证支付流程完整性的开发与运维场景。

限制

知识与 API 可能变化，应始终优先参考当前官方文档与发布说明。文档根地址：https://developer.sumup.com/ ；LLM 入口：https://developer.sumup.com/llms.txt 。关于具体收费、价格、平台支持范围等细节，资料中暂未提供。