1. 支付SDK API接入参数全景图
1.1 参数分类体系
支付SDK API的接入参数按照功能域与调用阶段可分为五大类别。每一类参数在接口签名、业务路由、资金清算和安全校验中承担不同的角色。下图为参数分类全景架构。
1.2 参数分类与测试对照
| 分类 | 典型参数示例 | 测试条件 | 验收阈值 |
|---|---|---|---|
| 认证参数 | app_id, sign, nonce_str, timestamp | 签名算法正确性、时间戳容差 ≤ 5 min | 签名校验通过率 100% |
| 订单参数 | out_trade_no, total_fee, body | 金额精度 ≤ 2 位小数、订单号幂等性 | 重复订单拒绝率 ≥ 99.99% |
| 支付方式参数 | trade_type, openid, bank_type | 每种 trade_type 对应字段必传清单 | 字段覆盖度 100% |
| 回调通知参数 | notify_url, return_code, transaction_id | 回调可达性、签名验签链路 | 回调成功率 ≥ 99.9% |
| 公共参数 | version, charset, format | 枚举值边界、默认值覆盖 | 枚举值合法率 100% |
1.3 参数表结构
单条参数在技术规范中由下列元数据字段构成，测试人员依据此结构构造测试用例：
| 字段 | 含义 | 注入工具/配置 |
|---|---|---|
| 参数名称 | 接口协议中的键名（如 sign） | API 网关报文头/请求体键值对 |
| 数据类型 | String / Number / Boolean / Object | JSON Schema 类型校验器 |
| 必填性 | 条件必填 / 非必填 / 禁止 | 自动化测试断言：必填缺省报错 |
| 最大长度 | 字符数或字节数上限 | 边界压力测试工具 |
| 合法值/枚举 | 固定列表或正则表达式 | 枚举覆盖测试数据源 |
| 示例值 | 符合规范的样例 | 沙箱 Mock 初始参数 |
1.4 参数命名规则
- 蛇形风格（snake_case）：全小写字母与下划线组合，如
out_trade_no、notify_url。此为支付 SDK 主流风格。 - 长度限制：参数名称一般不超过 32 个 ASCII 字符；总请求体建议 ≤ 8 KB。
- 字符集：仅允许
a-z、0-9、_；禁止中文或特殊符号出现在参数名中。 - 语义规则：前缀区分场景——
out_表示商户本地流水号、sub_表示子商户/子用户字段。
调参策略提示：接入初期优先锁定认证参数与订单参数的必填组合。建议在 Postman 或 Echo 工具中维护一份符合规范的全量参数表，逐字段标记“已测/未测/边界通过”。沙箱环境中先用公共参数与认证参数打通，再逐层叠加支付方式与回调参数。
1.5 参数完整性测试步骤
- 拉取最新 API 文档，导出参数表结构元数据。
- 按照 1.1 节分类原则，将参数填入测试框架的参数池。
- 分别为每类参数构造 3 组用例：标准通过、必填缺失、类型/长度边界。
- 使用网关抓包工具（如 Charles / Wireshark）比对实际发送报文与文档表结构。
- 统计参数覆盖度与签名验签失败率，输出全景验收报告。
常见误差分析：
· 参数命名中混入驼峰风格（如 outTradeNo）导致签名验签失败。
· 回调参数 notify_url 中的端口号被 NAT 映射错误，造成回调无法到达。
· 公共参数 format 未与请求体实际序列化格式一致（如写为 XML 却发出 JSON）。