4.1 商户产品开通
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>代理商给下属商户进行开通对应的产品，目前只支持开通<strong>扫码、结算、分账</strong>产品三种，特别是需要分账的商户，请务必申请开通分账权限。</li>
<li>需要具体到开通微信、支付宝、银联的某种能力的产品，开通产品时候，需要上送当前商户的费率等信息（银联分段费率不区分借贷记）。</li>
<li>开通产品接口支持重复调用接口，但每请求一次就会同步请求上游进行更新，请合理安排业务场景，无需过多请求。</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://pay.test.891tech.com/website/agent/isv/openProduct.action</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST 【application/json】</li>
</ul>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">bizType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口类型，固定值：openProduct</td>
</tr>
<tr>
<td style="text-align: left;">productType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>产品类型,APPPAY：扫码产品；SETTLEMENT：结算产品；SPLIT：分账产品</td>
</tr>
<tr>
<td style="text-align: left;">agentNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>代理商编号</td>
</tr>
<tr>
<td style="text-align: left;">merchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>子商户编号</td>
</tr>
<tr>
<td style="text-align: left;">payType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>支付类型，请查询字段说明（非扫码产品无需上送）</td>
</tr>
<tr>
<td style="text-align: left;">appPayType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>客户端类型，请查询字段说明 （非扫码产品无需上送）</td>
</tr>
<tr>
<td style="text-align: left;">value</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手续费率费率（%），非银联产品必填 （非扫码产品无需上送，默认使用代理商费率）；分账时候表示分账的比例；</td>
</tr>
<tr>
<td style="text-align: left;">minFee</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>最小收取手续费费用（元），非银联产品必填 （非扫码产品无需上送，默认使用代理商费率）；分账的时候表示最低分账的交易金额</td>
</tr>
<tr>
<td style="text-align: left;">calcType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银联费率收取的方式，固定值：RATIO，表示比率</td>
</tr>
<tr>
<td style="text-align: left;">unionminvalue</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银联1000以下费率（%），比如0.38%，请输入0.38 （非扫码产品无需上送）</td>
</tr>
<tr>
<td style="text-align: left;">unionminminFee</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银联1000以下最小收取费用（元），比如0.01元，请输入0.01 （非扫码产品无需上送）</td>
</tr>
<tr>
<td style="text-align: left;">unionmaxvalue</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银联1000以上费率，同上说明（非扫码产品无需上送）</td>
</tr>
<tr>
<td style="text-align: left;">unionmaxminFee</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银联1000以上最小收取费用，同上说明 （非扫码产品无需上送）</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;bizType&quot;: &quot;openProduct&quot;,
&quot;agentNo&quot;: &quot;AG00000000000012&quot;,
&quot;data&quot;: &quot;mYlMSBNcvvCXhmloB0hAuVnjufk/lNhF19XfPYGrQExA3yo5ek975ODiaXyspNRJD8r/sbvDFowPuF2ZTLug30DyJIXuMVae+GhkSCz8gWglfm57w59I+S/MZ7YzgxpJPFAPCpB4zFUWWwgVy/ycwHOSIWNvCpBYLs10hm/WUPDAVWLSLmNgpCqi/nJVdzoO966MWXZW/ExnruH7rXbsU+YGHuPI9IJrudB6Wos80usUGZ533tYqvElVvYwIQ94A&quot;,
&quot;signature&quot;: &quot;X0AjpXl7hOrukGjv4rsFQ/Cdey89drMiRujHzRPWnKmso0WCy9GcRj6Mwfv0yA6SbB+ziZeGCtbyhaWpO/ZOrjICj6gy8vDZz5inMtDDkNcMpz0+pQToCK837fv20T6iJygkjRAJEEuJJuUEdwTCyr8ZXSOsdU3a/gFnKyA3XEUYQJiBuC62++2GedIyZkILPLZd3qu3vh0dknVzRW4BAoJbo503de/hZcF3YUTfG6BCyPcx23s7lZx+bTPkfSCF5UqldwUSJfWmuzmK/yDc20M85M+CXXeTYvXPSI8Qh+pzot/2xkeI4aIRmwQqajnC6Raqwag1pgzESIiQ+drAnw==&quot;,
&quot;retCode&quot;: &quot;C0000&quot;,
&quot;retMsg&quot;: &quot;成功&quot;
}</code></pre>
<h5>返回解密以后示例</h5>
<pre><code>{
&quot;appPayType&quot;: &quot;ALIPAY&quot;,
&quot;feeRanges&quot;: &quot;&quot;,
&quot;maxFee&quot;: &quot;15.0&quot;,
&quot;merchantNo&quot;: &quot;M00000000000183&quot;,
&quot;minFee&quot;: &quot;0.02&quot;,
&quot;payReportMsg&quot;: &quot;报备中&quot;,
&quot;payReportStatus&quot;: &quot;DOING&quot;,
&quot;payType&quot;: &quot;SWIPE&quot;,
&quot;value&quot;: &quot;0.38&quot;
}</code></pre>
<h5>解密同步返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>子商户编号</td>
</tr>
<tr>
<td style="text-align: left;">appPayType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户端类型，请查询字段说明</td>
</tr>
<tr>
<td style="text-align: left;">payType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>支付类型，请查询字段说明</td>
</tr>
<tr>
<td style="text-align: left;">value</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>交易费率（%）</td>
</tr>
<tr>
<td style="text-align: left;">minFee</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>最小手续费（元）</td>
</tr>
<tr>
<td style="text-align: left;">maxFee</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>最高手续费（元），默认使用代理或者系统配置的最高费率</td>
</tr>
<tr>
<td style="text-align: left;">feeRanges</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>银联费率返回的JSON字段，下面会说明</td>
</tr>
<tr>
<td style="text-align: left;">payReportMsg</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开通返回的信息</td>
</tr>
<tr>
<td style="text-align: left;">payReportStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开通的状态，请查询字段说明</td>
</tr>
</tbody>
</table>
<h5>feeRanges银联费率字段返回样例</h5>
<pre><code>{
&quot;appPayType&quot;: &quot;UNIONPAY&quot;,
&quot;feeRanges&quot;: [{
&quot;endAmount&quot;: &quot;1000&quot;,
&quot;freeValue&quot;: &quot;0.38&quot;,
&quot;maxFreeValue&quot;: &quot;11.0&quot;,
&quot;minFreeValue&quot;: &quot;0.05&quot;,
&quot;onlineCardType&quot;: &quot;DEBIT&quot;,
&quot;startAmount&quot;: &quot;0&quot;
}, {
&quot;endAmount&quot;: &quot;999999&quot;,
&quot;freeValue&quot;: &quot;0.56&quot;,
&quot;maxFreeValue&quot;: &quot;12.0&quot;,
&quot;minFreeValue&quot;: &quot;0.06&quot;,
&quot;onlineCardType&quot;: &quot;DEBIT&quot;,
&quot;startAmount&quot;: &quot;1000&quot;
}, {
&quot;endAmount&quot;: &quot;1000&quot;,
&quot;freeValue&quot;: &quot;0.38&quot;,
&quot;maxFreeValue&quot;: &quot;13.0&quot;,
&quot;minFreeValue&quot;: &quot;0.05&quot;,
&quot;onlineCardType&quot;: &quot;CREDIT&quot;,
&quot;startAmount&quot;: &quot;0&quot;
}, {
&quot;endAmount&quot;: &quot;999999&quot;,
&quot;freeValue&quot;: &quot;0.56&quot;,
&quot;maxFreeValue&quot;: &quot;14.0&quot;,
&quot;minFreeValue&quot;: &quot;0.06&quot;,
&quot;onlineCardType&quot;: &quot;CREDIT&quot;,
&quot;startAmount&quot;: &quot;1000&quot;
}],
&quot;maxFee&quot;: &quot;&quot;,
&quot;merchantNo&quot;: &quot;M00000000000183&quot;,
&quot;minFee&quot;: &quot;&quot;,
&quot;payReportMsg&quot;: &quot;失败:平台商未设置相应的产品费率&quot;,
&quot;payReportStatus&quot;: &quot;FAIL&quot;,
&quot;payType&quot;: &quot;SWIPE&quot;,
&quot;value&quot;: &quot;&quot;
}</code></pre>
<h5>feeRanges银联费率字段说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">startAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开始金额</td>
</tr>
<tr>
<td style="text-align: left;">endAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>结束金额，目前上限为999999，当前数值为渠道数值，会有变化</td>
</tr>
<tr>
<td style="text-align: left;">freeValue</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易手续费</td>
</tr>
<tr>
<td style="text-align: left;">minFreeValue</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>最小手续费用（元）</td>
</tr>
<tr>
<td style="text-align: left;">maxFreeValue</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>最高手续费用（元）</td>
</tr>
<tr>
<td style="text-align: left;">onlineCardType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>借贷记，CREDIT：贷记卡，DEBIT：借记卡</td>
</tr>
</tbody>
</table>