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