测试与排障
错误码与排障
先检查顶层 result_code/error_code,再检查 biz_response.result_code/error_code/error_code_standard。下表为已核对的常见默认码;部署映射可能改变错误文案或标准码,程序不得按中文/英文提示文本分支。
转人工时提供的诊断信息
- 环境与设备: 环境、商户/门店标识、调用方
terminal_sn、目标设备号。 - 订单与流水:
out_trade_no/client_sn、sn、tsn、退款号。 - 请求与响应: 请求发生时间及时区、接口路径、HTTP 状态、两层结果码、平台返回的追踪标识(如有)。
- 排查记录: 已尝试的查询及设备现象。
请求/响应只提供脱敏样本;移除密钥、完整卡号、个人敏感信息。通过开户时指定的技术支持渠道提交,持续保留待核对状态。
联调验收与上线
下列用例应在授权测试环境执行并留存脱敏证据。本次文档校验不等于这些用例已在真实终端/渠道通过;没有模拟器的场景需安排受控联调。
上线前确认
- 生产商户、门店、目标设备与调用方凭证绑定一致,币种和支付方式开通完成。
- 测试/生产 URL、公钥、密钥、回调域名分离;密钥安全存储,TLS 证书有效。
- 支付、退款、通知、超时和重复业务用例有可回溯证据,未知状态有人工接管流程。
- 已确认频控、设备固件、退款期限/权限/手续费、取消回调范围、对账与结算规则。
- 配置监控和支持联系人;先按约定完成小额生产验证,再逐步放量。
各项能力的确认方、所需证据及原文代码核对范围见维护依据与待确认项。
