3.6 分期续费获取缴费链接接口(保司收费)
<p>[TOC]</p>
<p>请求模式：渠道方→鸿雁平台</p>
<p>接口描述：续费接口（收银台代收）</p>
<p>测试接口地址：<a href="https://hermesgyb.zhlic.net/avatar/general/general/renewOrder">https://hermesgyb.zhlic.net/avatar/general/general/renewOrder</a></p>
<p>生产接口地址：<a href="https://gyb.zhlic.net/avatar/general/renewOrder">https://gyb.zhlic.net/avatar/general/renewOrder</a></p>
<h3>请求头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td>贯穿保单始终的订单号， 要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>请求体</h3>
<p><code>renewBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>续费金额</td>
<td>renewMoney</td>
<td>BigDecimal</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>续费时间</td>
<td>renewDate</td>
<td>Date</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>缴费期数起数</td>
<td>startPeriod</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>缴费期数止数</td>
<td>endPeriod</td>
<td>Integer</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>渠道支付id</td>
<td>payId</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>渠道支付类型</td>
<td>payType</td>
<td>varchar</td>
<td>Y</td>
<td>1 纯续费 2 签约续费</td>
</tr>
<tr>
<td>收银台跳转地址</td>
<td>redirectUrl</td>
<td>varchar</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>支付失败跳转链接</td>
<td>errorUrl</td>
<td>varchar</td>
<td>N</td>
<td></td>
</tr>
<tr>
<td>微信openid</td>
<td>openId</td>
<td>varchar</td>
<td>CY</td>
<td>小程序支付必传</td>
</tr>
<tr>
<td>小程序appid</td>
<td>miniAppId</td>
<td>varchar</td>
<td>CY</td>
<td>小程序支付必传</td>
</tr>
<tr>
<td>小程序标识</td>
<td>miniAppFlag</td>
<td>varchar</td>
<td>CY</td>
<td>1-是 0-否</td>
</tr>
</tbody>
</table>
<h3>响应头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>响应时间</td>
<td>respTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td>贯穿保单始终的订单号， 要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>响应体</h3>
<p><code>respBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>支付连接</td>
<td>payUrl</td>
<td>varchar</td>
<td>CY</td>
<td>成功时返回</td>
</tr>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>处理状态码</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果状态码</td>
</tr>
<tr>
<td>处理结果描述</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果描述</td>
</tr>
<tr>
<td>时间戳</td>
<td>timeStamp</td>
<td>Long</td>
<td>CY</td>
<td>唤起小程序支付所需参数</td>
</tr>
<tr>
<td>随机字符串</td>
<td>nonceStr</td>
<td>varchar</td>
<td>CY</td>
<td>唤起小程序支付所需参数</td>
</tr>
<tr>
<td>微信参数</td>
<td>prepayId</td>
<td>varchar</td>
<td>CY</td>
<td>唤起小程序支付所需参数</td>
</tr>
<tr>
<td>签名类型</td>
<td>signType</td>
<td>varchar</td>
<td>CY</td>
<td>唤起小程序支付所需参数</td>
</tr>
<tr>
<td>签名</td>
<td>paySign</td>
<td>varchar</td>
<td>CY</td>
<td>唤起小程序支付所需参数</td>
</tr>
</tbody>
</table>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;head &quot;: {
&quot;interfaceType&quot;: &quot;renew&quot;,
&quot;orderNo&quot;: &quot;202205190000000164&quot;,
&quot;policySource&quot;: &quot;HN_SZ&quot;,
&quot;reqTime&quot;: &quot;2021-12-1411: 16: 21&quot;,
&quot;uuid&quot;: &quot;27ac85e3-97d7-4d13-85a4-6622a2a72c0a&quot;
},
&quot;renewBody&quot;: {
&quot;endPeriod &quot;: 3,
&quot;payId&quot;: &quot;X44002637220121330016&quot;,
&quot;payType&quot;: &quot;1&quot;,
&quot;policyNo&quot;: &quot;X44002637220121330016&quot;,
&quot;redirectUrl&quot;: &quot;http: //testexchange.yuanbaobaoxian.com/result/pay?orderId=210201100320387PO731698&amp;renewalId=210201111621665AR810203&quot;,
&quot;renewDate&quot;: &quot;2021-12-16 11:16:21&quot;,
&quot;renewMoney&quot;: 58.16,
&quot;startPeriod&quot;: 2
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;renew&quot;,
&quot;orderNo&quot;: &quot;202205190000000164&quot;,
&quot;policySource&quot;: &quot;HN_SZ&quot;,
&quot;reqTime&quot;: 1639451781000,
&quot;respTime&quot;: 1670379695807,
&quot;uuid&quot;: &quot;27ac85e3-97d7-4d13-85a4-6622a2a72c0a&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;payUrl&quot;: &quot;https://hermes-pay.chinahuanong.com.cn/payPage?data=aA6ieBImj4Up%2BOlmtoQZsYD06k4dP3QADCA25%2Bq43gndW1qfrIDS8LMDVWaXVlaE&amp;secret=asT4eXTwyxiOZ5TdalsG5T57ohoK5qQI2wDv41reB2mOsYk1fMSawE9qp%2BzjIm64ynM9dfL1J9sY%0AxtZokk0ObppSdhUYueJLNq6%2BIsrI3NG2YwkF0ZXaNlcTEf14uU%2Bs5hSFfE9AK3HlDpMzprzD%2FlvO%0AgZ0BQjyYrRChSFFX3uI%3D&amp;merchantCode=100003&quot;,
&quot;policyNo&quot;: &quot;X44002637220121330016&quot;
}
}
</code></pre>