3.补充说明(重要,请务必细读)
<h1>接口调用过程的补充说明</h1>
<h2>第一步 调用签约接口</h2>
<p>用户签约协议
PS:由客户收集后上传自然人的身份证正反面图片,当接口返回失败,则需检查数据重新调用第一步;</p>
<h2>第二步 用户签约结果获取</h2>
<p>PS:有2种方式查询/获取这次请求的签约结果,这2种方式若接口返回状态码为“S”则可以继续进行第三步,若非“S”,则需检查数据重新调用第一步;
方式一:对接签约回调接口
在用户签约协议接口参数中传入了notify_url回调地址字段则平台会发起签约异步回调 通知;
接口描述见 异步回调(签约异步回调通知报文结构)
方式二:对接用户签约结果查询
接口描述见用户签约结果查询
关于签约说明:
请事先和商务经理沟通好签约原则;
原则上我们系统的API签约要求是必须先签约才能下发,否则下发接口或下发状态查询接口会对未签约的订单进行报错返回;
但是商户经理可以对新客户给予一定的容忍期.24小时到7*24小时不等,在容忍期内新的自然人订单可以未签约进行发放,但是发放过后该自然人仍然没有提供签约信息(调用“用户签约协议接口”完成),该自然人将无法正确下发,这种情况下调用客户忽略第一步和第二步;</p>
<h2>第三步 调用下发接口</h2>
<p>下发接口根据不通的支付渠道分三个接口,酌情调用
银行卡下发
PS:走银行通道下发的订单调用;
支付宝下发
PS:支付宝通道下发的订单调用;
微信下发
PS:微信通道下发的订单调用;</p>
<h2>第四步 下发异步回调商户通知</h2>
<p>下发异步回调商户通知
PS:获取(银行or支付宝or微信)下发接口的最终状态,根据返回的状态码执行后续逻辑:</p>
<ol>
<li>若获取到的状态为C1(成功状态),看到此状态则可以在5分钟后调用电子回单接口(若为银行卡下发,建议t+1后调用)获取电子回单了;</li>
<li>若获取到的状态为A1,C2(失败状态),如果看到这些状态,如当前订单仍需要发放,则需要再次创建新的订单从下发开始调用接口;</li>
<li>调用客户收到下发回调后请给我方响应,返回大写的 SUCCESS,若未收到正确的返回,将向该URL持续发送回调通知,发送间隔为30秒,2分钟,4分钟,10分钟,30分钟,2小时,4小时,8小时,16小时,24小时,最多额外通知10次;
若未对接回调请忽略第四步,直接执行第五步;如果已对接回调,同样需要将第五步的订单状态查询接口进行对接,避免未收到回调的情况下业务卡壳;
<h2>第五步 调用商户单笔下发订单状态查询接口</h2>
<p>商户下发订单状态查询
PS:获取已成功调用(银行or支付宝or微信)下发接口的订单状态:</p></li>
<li>其中A0,B0为中间状态.如果看到这个状态需要过一段时间继续调用接口直到获取到最终状态;</li>
<li>其中C1为最终成功状态,看到此状态则可以在5分钟后调用电子回单接口获取电子回单了;</li>
<li>其中A1,C2为最终失败状态,如果看到这些状态,如当前订单仍需要发放,则需要再次创建新的订单从下发开始调用接口;</li>
<li>该接口同一个订单在30秒内不能重复调用;
<h2>第六步 调用电子回单接口</h2>
<p>下载单笔电子回单URL获取
PS: 使用该接口获取电子回单;注意这里获取到的URL48小时后是有可能会失效的.如需长期保留回单请尽快下载后自行存储;</p></li>
</ol>
<p>关于超时处理的补充说明
注意:所有客户端主动发起的请求都有可能返回以下报文:</p>
<pre><code>{
&quot;ret_code&quot;:&quot;D001&quot;,
&quot;ret_msg&quot;:&quot;通讯中断(系统维护升级中,请稍候再试)&quot;
}</code></pre>
<p>当接口返回D001这个错误码时,可能是系统正处于维护中,暂时关闭了接口通讯,请延迟后再次调用;
关于充值记录查询的补充说明
注意:对于充值量很大的客户有可能返回以下报文:</p>
<pre><code>{
&quot;sign&quot;: &quot;Nkd6GTpSodwwO2dTlGpFRqD1GY6CetRlwb6EMuzkEnk=&quot;,
&quot;ret_code&quot;: &quot;Q001&quot;,
&quot;ret_msg&quot;: &quot;当前查询结果条数超返回限制(上限:100条),请调整查询条件!&quot;,
&quot;timestamp&quot;: &quot;20240924134825973&quot;
}</code></pre>
<p>当接口返回Q001 这个错误码时,说明本次查询条件查出来的数据超过了100条,超过了这边的返回最大限制,需要缩短查询条件重新进行查询; 若按天的充值量超过100条,请在对接该接口前和我们运营/技术进行沟通;</p>