Skip to main content

测试与验证

在全量接入之前,系统性的测试和验证是保证数据质量的关键步骤。

7.1 小批量优先策略

核心原则: 先用约100条商品测试,确认无误后再扩展到全量。
不要跳过前几个阶段直接上全量。小批量测试可以快速发现格式错误、字段缺失和编码问题,修复成本远低于全量数据出错后的回滚。

7.2 必填字段验证

确保以下必填字段都已正确填写:

7.3 价格格式验证

价格必须使用minor currency units(最小货币单位):
验证要点:
  • amount 必须大于等于0(0表示免费)
  • currency 使用ISO 4217三字母代码
  • 确认未将”元”误传为”分”(99.99 USD应传 9999 而非 99

7.4 URL验证

逐一检查所有URL:

7.5 SFTP连接测试

在正式上传数据前验证SFTP连通性:

7.6 API认证测试

验证API凭证和header配置:
如果返回200,说明认证配置正确。如果返回401或403,检查:
  • Bearer token是否正确
  • token是否过期
  • 账户权限是否已开通

7.7 常见错误排查

HTTP 400: invalid_payload

原因: 请求体格式错误或缺少必填字段。

HTTP 404: not_found

原因: 请求的Feed或商品不存在。

幂等性冲突

如果使用相同的 Idempotency-Key 发送了不同的请求体,可能导致冲突。每个不同的请求批次必须使用唯一的key。

7.8 Checkout Session测试

如果商家同时实现了Agentic Checkout端点,需要测试完整的交易流程。

创建会话

更新会话

完成支付

取消会话

测试以上四个流程,确认状态转换正确、错误处理完善。

7.9 Delegate Payment测试

Stripe提供测试模式(test mode)用于支付集成测试: 测试模式下不会产生真实交易,可以安全地验证完整支付流程。

7.10 数据同步监控

上线后持续监控数据同步状态:
下一章: 第8章:常见问题 — ACP接入常见问题解答