商户接入指引

我要上线

第一步:申请上线

一网通支付商户在完成系统测试之后,可联系分行申请上线并提交《一网通支付商户测试验收报告》。
总行测试验收通过后,会根据分行上报的商户上线申请表进行上线排期和银行端上线配置,配置完成后会通知商户并发送生产环境参数给商户。

第二步:替换生产参数

1. 替换分行号和商户号
    请将分行号和商户号更新为生产环境分行号和商户号(4位分行号+6位商户号=10位收单商户号)。
2. 替换接口的测试地址为生产地址
    请按照对接产品接口文档中的内容,将测试地址更新为生产地址。
3. 检查对接产品的个性化参数
    商户根据对接一网通产品的类型,以及是否开发该功能,核对招行生产配置参数与商户侧是否一致。“必选”参数将影响支付流程,请务必认真核对。

支付产品商户个性化参数说明约束条件说明
APP支付返回商户地址
必选招行分配商户的scheme值
H5支付微信校验文件可选适用于微信小程序商户,生产参数配置格式为“文件名+文件内容”
二维码支付URL白名单必选商户生成二维码的url
免密轮询非保付免密协议取消回调地址可选商户获取用户在银行端关闭免密支付功能或注销一网通用户的回调通知
免密轮询保付免密协议取消回调地址可选商户获取用户在银行端关闭免密支付功能或注销一网通用户的回调通知
保付模式补扣回调地址可选商户获取招行补扣用户垫资欠款成功的回调通知

第三步:设置并替换支付密钥

登录“商户服务平台”,设置支付密钥。详见“商户服务平台使用指南——基础功能——秘钥管理”操作指引。
注意:
1、 商户请求报文需要使用支付密钥进行签名,因此对接生产环境需要使用商户设置的支付密钥进行签名。
2、 建议支付密钥定期更换,更换期间可能导致交易失败(一般需要1个小时后生效),因此请交易量小的时候更换。