5.测试环境联调说明

本文档描述收付通测试环境的联调流程、接口地址及模拟机制。

5.1 测试流程步骤

步骤一：获取测试参数

测试参数必须是唯一的，每个入网商户需找通联客户经理颁发唯一系统对接参数：

参数项	说明
商户号	由通联颁发，唯一
用户名	由通联颁发
用户密码	由通联颁发
通联公钥证书	测试环境统一，与生产环境公钥不同

步骤二：生成商户密钥对

商户根据附录E.openssl生成rsa密钥对参考生成密钥：

密钥类型	处理方式
公钥	提交给通联客户经理
私钥	商户自行妥善保存，切勿泄露

步骤三：接口开发与测试

商户根据自身业务情况，选择开发对应的接口
开发完毕后进行接口联调测试

步骤四：生产环境配置

联调通过后：

通联分公司客户经理向商户获取对接的生产公钥
配置到通联生产平台中

5.2 测试环境接口地址

接口地址

目标环境	接口地址	环境说明
测试环境	https://tlt-test.allinpay.com/aipg/ProcessServlet	接口对接测试环境

WEB 查询环境

端类型	地址	说明
商户端	https://cus-test.allinpay.com/ts-cloud-dev-web/#/login	商户 WEB 后台
运营端	http://192.168.28.61:8079/utcusContainer/index	运营 WEB 后台

测试环境出口 IP

对于来自通联端的请求（如 SFTP/FTP 对账文件推送、通知类报文），商户需设置通联端服务器白名单。

101.95.191.142
116.228.64.49
140.207.168.194

5.3 测试环境模拟机制

模拟机制说明

特性	说明
返回结果	由模拟程序返回，未真实发往银行渠道
真实验证	不进行真实验证
短信下发	不下发短信到手机
默认验证码	四要素+短信验证、快捷签约默认验证码均为 `111111`
卡号要求	必须符合发卡行卡 BIN 规则

5.3.1 代收付交易模拟机制

⚠️ 重要：测试环境只能模拟 3开头通联返回码 和 0000，其他返回码无法模拟。模拟 2008 时，后两位 ss 表示超过 3 秒。

A. 户名模拟规则

格式：XXXCCCCSS

组成部分	说明
XXX	实际户名
CCCC	返回码（4位数字）
SS	超时时间（2位数字，单位：秒）

要求：CCCCSS 必须为 6 位数字字符，否则不符合该规则

示例：

户名：陈夏雨300860
解析：
  - 实际户名：陈夏雨
  - 返回码：3008
  - 超时时间：60 秒

若返回码非通联定义返回码，则返回成功

B. 金额模拟规则

格式：金额（分）≥ 6 位时，取右边 6 位 CCCCSS

组成部分	说明
CCCC	返回码（4位数字）
SS	处理时间（2位数字，单位：秒）

2 开头的返回码模拟为「处理中」状态

5.3.2 验证类模拟机制

验证类接口可通过户名模拟规则返回相应结果：

格式：上送用户名为 ccccss

示例：

上送用户名	模拟返回
张三306501	返回码 3065（户名错）

5.3.3 协议支付模拟机制

签约前置条件

条件	要求
身份证类型	仅支持国民身份证
手机号	必须为 11 位
交易金额	限制 1 万以内
短信验证码	固定为 `111111`（不下发短信）

协议支付签约模拟规则

卡号结尾	模拟结果
0、1、9	成功
2	无效卡号
3	已挂失卡
4	余额不足
5	无此账户
6	无此原交易
7	户名错
8	交易超时

协议支付扣款模拟规则

若上送金额为 6 位或以上，需符合 ccccss 规则：

组成部分	说明
cccc	通联返回码
ss	处理时间（单位：秒）

⚠️ 若输入格式不符合规则，会报 2000（没有该项业务的权限）

快速参考

模拟规则速查表

模拟方式	适用场景	格式规则
户名模拟	代收付交易、验证类	`户名+返回码(4位)+超时秒数(2位)`
金额模拟	代收付交易	金额≥6位时取后6位 `返回码+超时秒数`
卡号结尾模拟	协议支付签约	0/1/9=成功，2=无效卡号，3=挂失...
金额模拟	协议支付扣款	6位金额 `返回码+处理秒数`

默认值汇总

项目	测试环境默认值
短信验证码	`111111`
四要素验证码	`111111`
快捷签约验证码	`111111`

流程图

┌─────────────────┐
│  1.获取测试参数  │  ← 联系通联客户经理
└────────┬────────┘
         ↓
┌─────────────────┐
│  2.生成密钥对    │  ← 公钥交通联，私钥自存
└────────┬────────┘
         ↓
┌─────────────────┐
│  3.接口开发测试  │  ← 按接口要求联调测试
└────────┬────────┘
         ↓
┌─────────────────┐
│  4.生产环境配置  │  ← 审批通过后配置生产公钥
└─────────────────┘