3.4 承保获取缴费链接(保司收费)
<p>[TOC]</p>
<p>请求模式:渠道方→鸿雁平台</p>
<p>接口描述:适用于保险公司收保费的场景</p>
<p>测试接口地址:<a href="https://hermesgyb.zhlic.net/avatar/general/payUrl">https://hermesgyb.zhlic.net/avatar/general/payUrl</a></p>
<p>生产接口地址:<a href="https://gyb.zhlic.net/avatar/general/payUrl">https://gyb.zhlic.net/avatar/general/payUrl</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>格式为:yyyy-MM-dd HH:mm:ss。</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>payInfo</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>投保单号</td>
<td>proposalNo</td>
<td>varchar</td>
<td>Y</td>
<td>保单唯一标识信息</td>
</tr>
<tr>
<td>支付类型</td>
<td>tradeType</td>
<td>varchar</td>
<td>Y</td>
<td>微信 PC 扫码支付:W01; 支付宝 PC 扫码支付:A01; PC 收银台:P01;微信小程序支付插件:C01</td>
</tr>
<tr>
<td>支付成功跳转地址</td>
<td>redirectUrl</td>
<td>varchar</td>
<td>CY</td>
<td>小程序支付不传</td>
</tr>
<tr>
<td>支付失败跳转地址</td>
<td>errorUrl</td>
<td>varchar</td>
<td>CY</td>
<td>小程序支付不传</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>CY</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>proposalNo</td>
<td>varchar</td>
<td>Y</td>
<td></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>payUrl</td>
<td>varchar</td>
<td>CY</td>
<td>支付类型非扫码支付(P01)时返回该值,跳转此地址进行支付</td>
</tr>
<tr>
<td>二维码链接</td>
<td>codeUrl</td>
<td>varchar</td>
<td>CY</td>
<td>支付类型为扫码支付(W01/A01)时返回该值, 用该链接生成二维码进行扫码支付</td>
</tr>
<tr>
<td>交易单号</td>
<td>trxid</td>
<td>varchar</td>
<td>CY</td>
<td>微信小程序支付插件支付(C01)时返回该值,用于小程序插件支付</td>
</tr>
</tbody>
</table>
<h3>小程序支付插件地址</h3>
<p><a href="https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx819a5f24689d6536&token=147311830&lang=zh_CN">https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx819a5f24689d6536&token=147311830&lang=zh_CN</a></p>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;head &quot;: {
&quot;interfaceType&quot;: &quot;payUrl&quot;,
&quot;orderNo&quot;: &quot;P2212181104155571815&quot;,
&quot;policySource&quot;: &quot;HN_NY&quot;,
&quot;reqTime&quot;: 1671332656035,
&quot;uuid&quot;: &quot;HN_NY4505_1671332656035&quot;
},
&quot;payInfo&quot;: {
&quot;proposalNo&quot;: &quot;Y51012740220000025171&quot;,
&quot;errorUrl&quot;: &quot;https://fca.chinahuanong.com.cn/chic-plus/payBack/sync?tradeNo=P2212181104155571815&quot;,
&quot;redirectUrl&quot;: &quot;https://fca.chinahuanong.com.cn/chic-plus/payBack/sync?tradeNo=P2212181104155571815&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;payUrl&quot;,
&quot;orderNo&quot;: &quot;P2212181104155571815&quot;,
&quot;policySource&quot;: &quot;HN_NY&quot;,
&quot;respTime&quot;: 1671332656219,
&quot;uuid&quot;: &quot;HN_NY4505_1671332656035&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;payUrl&quot;: &quot;https://pay.chinahuanong.com.cn/payPage?data=kVBsSsqYAYR8Xw13kKQ%2BRA%2Fg4xh8hFxBirK%2FAjOB%2FSXS5zPoJ4DGb2zJo%2B0hJuwY&amp;secret=h9zauGzeL2hYSzsn3MzYnq2hWZdN7WDIx%2FkRCd%2BHDnqUusbAr0uDIEl%2B4IfWMXaMhkAGpglL1qjM%0AzKAeNuY%2FBTdjzG2Sq2AXZTmeX72NsrpiUeuysqx1whVphyJvjibwYo8euh%2BZhM%2FEYCP2jvucOAA9%0AlyQ29%2BkollyzsF00yJ0%3D&amp;merchantCode=100003&amp;pcPay=1&quot;
}
}
</code></pre>