产品流程
STEP1:签约流程
免密签约可直接调用签约API,或调用一网通账户开户相关接口,具体由业务场景决定。
1. 调用签约API
以下为签约交互时序图示例。
商户系统与一网通支付系统主要交互说明:
步骤1:用户在商户前端页面发起签约。
步骤2:商户后台调用签订支付协议接口。参见【签订支付协议API(未安装招商银行APP)】或【签订支付协议API(已安装招商银行APP)】或【签订支付协议API(PC端签约二维码)】
注:商户需判断设备是否安装招行银行APP,对应跳转到招行APP内或招行H5页面进行签约。提供代码示例,参见【判断是否安装招商银行APP】
步骤3:用户在招商银行签约页面,输入支付密码,提交签约授权。
步骤4:系统校验成功后,返回签约结果。
步骤5:商户后台收到成功签约结果通知。参见【支付协议签订成功回调通知】
步骤6:商户后台查询签约结果。参见【查询支付协议API】
2. 一网通账户开户&签约
招行合作商户对接一网通账户开户API,已同时具备开户&签约功能,具体以实际的业务场景为准。
STEP2:资金冻结流程
以下为资金冻结交互时序图示例,具体由业务场景决定。
商户系统与一网通支付系统主要交互说明:
步骤1:用户在商户前端页面发起服务,根据业务场景可省略此步骤。
步骤2:服务结束后,商户前端向后台系统请求生成订单,并发起资金冻结请求。参见【资金冻结API】
步骤3:系统处理交易成功后,同步返回交易状态。参见【资金冻结API】
步骤4:商户后台收到资金冻结交易结果通知。参见【资金冻结交易结果异步通知API】
步骤5:商户后台查询交易状态。参见【交易状态查询API】
注1:建议在用户发起服务前,商户后台先调用【查询支付协议API】检查用户当前协议状态,如返回结果码
rspCode
为SUC0000
,即表示支付协议状态正常,可允许服务继续进行,否则对返回结果码进行处理,例如:重新发起签约。
STEP3:资金解冻流程
资金解冻交互时序图可参考资金冻结。
商户系统与一网通支付系统主要交互说明:
步骤1:服务结束后,商户前端向后台系统请求生成订单,并发起资金解冻请求。参见【资金解冻API】
步骤2:系统处理交易成功后,同步返回交易状态。参见【资金解冻API】
步骤3:商户后台收到资金解冻交易结果通知。参见【资金解冻交易结果异步通知API】
步骤4:商户后台查询交易状态。参见【交易状态查询API】
注1:资金冻结完成扣款交易需要校验签约协议的有效性,请在资金解冻或完成扣款前,保证协议的有效性。
STEP4:资金冻结完成扣款流程
资金冻结完成扣款交互时序图可参考资金冻结。
商户系统与一网通支付系统主要交互说明:
步骤1:服务结束后,商户前端向后台系统请求生成订单,并发起资金冻结完成扣款请求。参见【资金冻结完成扣款API】
步骤2:系统处理交易成功后,同步返回交易状态。参见【资金冻结完成扣款API】
步骤3:商户后台收到资金冻结交易结果通知。参见【资金冻结完成扣款结果异步通知API】
步骤4:商户后台查询交易状态。参见【交易状态查询API】
注1:资金冻结完成扣款交易需要校验签约协议的有效性,请在资金解冻或完成扣款前,保证协议的有效性。