sumup-testing

SumUp 沙盒测试指南

在设置测试、设计场景以及验证 SumUp 集成时使用此技能。

测试环境设置

1. 仅使用沙盒商家账户。
2. 确认凭据对应沙盒环境。
3. 在非生产环境中准备 webhook 端点。
4. 启用日志记录，记录 checkout id、reference、status 和 error code。

核心银行卡测试数据

除非文档另有说明，否则使用以下默认值：

• CVV：任意 3 位数字（例如 123）
• 有效期：任意未来日期（例如 12/30）
• 持卡人：任意姓名

正常流程银行卡：

• VISA 4200 0000 0000 0091
• Mastercard 5200 0000 0000 0007

3DS 挑战银行卡：

• VISA 4200 0000 0000 0042
• Mastercard 5200 0000 0000 0015

人为触发失败的约定

• 对于技能级别的测试方案，使用 amount = 11 作为默认的强制失败触发值。
• 如果某个集成已采用规范的基于金额的失败方式（例如 42.01、42.76、42.91），则两种方式都要运行，并记录该流程以哪种方式为准。

端到端冒烟测试方案

1. 使用唯一的 checkout_reference 创建 checkout。
2. 使用正常流程银行卡完成付款。
3. 验证前端回调／结果处理。
4. 验证后端在履行订单前会获取最终的已付款状态。
5. 验证 webhook 送达情况及幂等处理。
6. 使用强制失败金额重复测试，并确认订单仍未付款。

cURL 框架

curl -X POST "https://api.sumup.com/v0.1/checkouts" \
  -H "Authorization: Bearer $SUMUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "checkout_reference": "order-12345",
    "amount": 11,
    "currency": "EUR",
    "pay_to_email": "[email protected]",
    "description": "Sandbox test payment"
  }'

根据所选流程和身份验证模型调整载荷字段。

SDK 冒烟测试指南

• 为每个集成界面（服务器 SDK、移动 SDK、widget）保留一个冒烟测试。
• 断言规范化结果：success、pending、failed。
• 捕获并存储用于对账的键：checkout id、transaction id/code、merchant code、reference。

必需的 QA 矩阵

• 正常流程付款成功。
• 强制失败付款不会履行订单。
• 3DS 挑战流程完成并返回预期状态。
• 重复 reference 的处理结果具有确定性。
• 过期 checkout／会话流程会通过新建 checkout 进行处理。
• webhook 重试不会造成重复副作用。

必需的响应约定

收到测试规划请求时，始终提供：

1. 测试环境假设。
2. 要运行的确切场景（成功＋失败＋异步）。
3. 前端和后端的断言。
4. 为对账／调试需要收集的证据。