22.快捷支付绑卡签约
<p><strong>使用场景：</strong> </p>
<ul>
<li>客户发起签约申请，获取银行签约短信</li>
<li>签约绑卡短信确认</li>
</ul>
<p><strong>请求URL：</strong></p>
<ul>
<li><code>/quickpay/agree</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>请求类型：</strong></p>
<ul>
<li>application/json</li>
</ul>
<p><strong>请求参数：</strong> </p>
<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;">orgId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>服务商id，用于服务商代发起交易，传了此参数需要用服务商密钥进行加签</td>
</tr>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>通企付商户号，示例：E249974037860</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>默认为企业appId，若为服务商模式，需传入服务商appId</td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求时间，13位时间戳</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>版本（默认为1.0）</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名类型（MD5/RSA/SM2）</td>
</tr>
<tr>
<td style="text-align: left;">chanNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>渠道。allinpay：收银宝渠道</td>
</tr>
<tr>
<td style="text-align: left;">agreeType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>操作类型，1-签约申请 2-签约确认</td>
</tr>
<tr>
<td style="text-align: left;">merUserId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户自定义用户号</td>
</tr>
<tr>
<td style="text-align: left;">acctType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>卡类型不能为空：00:借记卡，02:准贷记卡/贷记卡</td>
</tr>
<tr>
<td style="text-align: left;">acctNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>银行卡号</td>
</tr>
<tr>
<td style="text-align: left;">acctName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>户名</td>
</tr>
<tr>
<td style="text-align: left;">identityType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>证件类型：0:身份证，2:护照，5:港澳通行证，6:台湾通行证</td>
</tr>
<tr>
<td style="text-align: left;">idNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>证件号，如末位是X，必须大写</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>银行预留手机号码</td>
</tr>
<tr>
<td style="text-align: left;">validDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>有效期，格式：MMYY</td>
</tr>
<tr>
<td style="text-align: left;">cvv2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>CVV2</td>
</tr>
<tr>
<td style="text-align: left;">channelExtra</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>渠道参数，JSON字符串，特定渠道发起的额外参数，如：<br>1、收银宝子商户号cusid,集团商户号orgid。示例：channelExtra={"orgid":"66045xxxxxxx","cusid":"66046xxxxxxxxx"}</br></td>
</tr>
<tr>
<td style="text-align: left;">verifyCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>短信验证码 签约确认时必填</td>
</tr>
<tr>
<td style="text-align: left;">thpInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>签约申请时返回,如果不为空,则确认签约时原样带上</td>
</tr>
</tbody>
</table>
<p><strong>返回参数</strong></p>
<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;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>返回状态：0-处理成功，9999-异常，具体错误详见msg字段</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td>返回信息：具体错误原因，例如：签名失败、参数格式校验错误</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>签名信息：对data内数据签名，如data为空则不返回</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Json</td>
<td>返回数据：json格式数据</td>
</tr>
</tbody>
</table>
<p><strong>data数据格式</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merUserId</td>
<td style="text-align: left;">string</td>
<td>商户自定义用户号</td>
</tr>
<tr>
<td style="text-align: left;">thpInfo</td>
<td style="text-align: left;">string</td>
<td>签约申请时返回,如果不为空,则确认签约时原样带上</td>
</tr>
<tr>
<td style="text-align: left;">agreeId</td>
<td style="text-align: left;">string</td>
<td>签约确认返回参数 协议编号,交易时需要传入</td>
</tr>
<tr>
<td style="text-align: left;">bankCode</td>
<td style="text-align: left;">string</td>
<td>签约确认返回参数 银行代码</td>
</tr>
<tr>
<td style="text-align: left;">bankName</td>
<td style="text-align: left;">string</td>
<td>签约确认返回参数 银行名称</td>
</tr>
</tbody>
</table>