关于 upgrade-sumup
面向升级 SumUp SDK、集成和 API 用法的迁移技能，适用于相关开发团队。内容涵盖版本盘点、破坏性变更分析、验证，以及分阶段发布和回滚规划。
主要功能
- 01SDK 与端点升级范围
- 02升级前盘点清单
- 03破坏性变更对比指引
- 04沙盒支付验证步骤
- 05分阶段发布与回滚规划
适用场景
- 01升级 SumUp SDK 版本
- 02替换已弃用的 SumUp 端点
- 03为支付集成迁移做准备
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/upgrade-sumup确认已加载。
附带文件agents/openai.yamlassets/small-logo.svg
详细介绍
SumUp 升级和迁移指南
知识和 API 可能会发生变化。请始终以当前官方文档和发行说明为准。
- 文档根目录：
https://developer.sumup.com/ - LLM 入口：
https://developer.sumup.com/llms.txt
当请求涉及升级、版本升级、弃用或迁移时，请使用此技能。
支持的升级目标
- 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 密钥/OAuth）、作用域及 webhook 签名设置。
- 受影响的环境（沙盒、预发布、生产）。
2) 破坏性变更差异
对于每次 SDK 或端点迁移：
- 对比变更日志和迁移说明。
- 确认重命名/移除的字段、枚举和回调签名。
- 确认异步/支付状态语义的行为变化。
- 确认已弃用的端点及所需的替代端点。
3) 实施迁移
- 一次升级一个部分（先服务器 SDK，再移动 SDK，最后 UI 集成）。
- 必要时保留兼容适配器，以隔离应用代码与 SDK 变更。
- 将已弃用的端点替换为当前的等效端点；适用时优先选择接受
merchant_code的端点。 - 除非有必要，否则保持 webhook 验证和幂等逻辑不变。
4) 升级后验证
- 在沙盒中执行支付成功路径。
- 执行有意失败测试（
amount = 11），并验证订单状态仍为未付款。 - 验证 3DS 重定向/挑战流程及返回处理。
- 验证 webhook 重试和幂等处理。
- 验证重复引用行为和对账字段。
5) 发布和回滚
- 分阶段发布（内部 -> 低流量 -> 全量流量）。
- 在可行的情况下添加发布开关。
- 在指标稳定前，保留好上一版本的回滚路径。
迁移清单
- 从活跃代码路径中移除所有已弃用的 SumUp 端点。
- 在各服务/应用中统一固定 SDK 的主/次版本。
- 重新生成并提交所有生成的 API 客户端。
- 更新集成测试，以适配新的响应结构。
- 更新运行手册，纳入新的状态码/错误码。
- 检查监控告警是否涵盖新的故障特征。
必需的响应规范
每个升级答复都应包括：
- 当前状态摘要和目标版本。
- 破坏性变更及受影响的代码部分。
- 最精简且安全的迁移步骤。
- 包含强制失败路径的验证计划。
- 回滚策略和继续/停止标准。
评论
支持 Markdown