进件第1步(保存证件信息)
<h5>简要描述</h5>
<ul>
<li>无</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://192.168.0.108/UnionPay-appMerchant/merchantInfo2/doMercAddStep1.do</code> </li>
</ul>
<h5>请求方式</h5>
<ul>
<li>post</li>
</ul>
<h5>请求参数示例</h5>
<pre><code>{
"legalCerno": "11010119890825147X",
"legalDate": "20120114-20220114",
"idCardBackImgUrl": "group1\/M00\/03\/EF\/Cgo4mGHfy5uAajdJAALHlY_CDZo849.jpg",
"indMcc": "5812",
"indCategory": "餐饮类",
"idCardFrontImgUrl": "group1\/M00\/03\/EF\/Cgo4mGHfy5uAajdJAALHlY_CDZo849.jpg",
"brandName": "UPOS",
"sign": "5621c18e222c5d40842f37c66f383fbf",
"addMerFlag": 0,
"token": "3613N2cXgvn12Gz37FMCIhES6GuDdlcv6rv9",
"isFailToManual": 2,
"rpid": "IZZZ5387NKL86YXE",
"merName": "个体户赵海堂",
"legalName": "赵海堂"
}
</code></pre>
<h5>json字段说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">字段名</th>
<th style="text-align: left;">必选</th>
<th>类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">legalCerno</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>法人证件号码</td>
</tr>
<tr>
<td style="text-align: left;">legalDate</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>身份证有效期</td>
</tr>
<tr>
<td style="text-align: left;">idCardBackImgUrl</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>身份证国徽面图片url</td>
</tr>
<tr>
<td style="text-align: left;">indMcc</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>行业MCC</td>
</tr>
<tr>
<td style="text-align: left;">indCategory</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>行业类别 默认标准类</td>
</tr>
<tr>
<td style="text-align: left;">idCardFrontImgUrl</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>身份证头像面图片url</td>
</tr>
<tr>
<td style="text-align: left;">brandName</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>品牌标识</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">addMerFlag</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>默认0</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>登录标识</td>
</tr>
<tr>
<td style="text-align: left;">isFailToManual</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>是否失败转人工 1 是 2 否</td>
</tr>
<tr>
<td style="text-align: left;">rpid</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>请求唯一流水号</td>
</tr>
<tr>
<td style="text-align: left;">merName</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>商户全称</td>
</tr>
<tr>
<td style="text-align: left;">legalName</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>法人姓名</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code>{
"ret_code": null,
"ret_msg": null,
"data": {
"code": 200,
"msg": "",
"resultData": {
"realData": {
"addDate": "2022-08-17",
"addMerFlag": 0,
"addTime": "14:43:19",
"brandNo": "100011882",
"buyingPower": 1,
"channel": "guanwang",
"collectway": 0,
"delayGuarantee": 1,
"enrollStatus": 2,
"idCardBackImgUrl": "group1\/M00\/03\/EF\/Cgo4mGHfy5uAajdJAALHlY_CDZo849.jpg",
"idCardFrontImgUrl": "group1\/M00\/03\/EF\/Cgo4mGHfy5uAajdJAALHlY_CDZo849.jpg",
"indCategory": "餐饮类",
"indMcc": "5812",
"intime": 1660718599826,
"isblacklist": 0,
"ischarge": 0,
"iswhitelist": 0,
"legalCer": 0,
"legalCerno": "11010119890825147X",
"legalDate": "20120114-20220114",
"legalName": "赵海堂",
"legalNameEnc": {
"cipherText": "U+DmCEEcqxUhnUYL\/RKo7g==",
"clearText": "赵海堂",
"maskText": "赵**"
},
"linkEmailEnc": {},
"linkManEnc": {},
"merBusinessType": 1,
"merCategory": 0,
"merLevel": "A",
"merModify": 1,
"merName": "个体户赵海堂",
"merNature": 1,
"merShortname": "个体户赵海堂",
"merStatus": 6,
"merType": 0,
"merareas": "湖北省,武汉市,江汉区",
"merdetailedaddress": "中国湖北省武汉市江汉区常青街道青年路558号-附1",
"merno": "110000000106808",
"posNumber": 0,
"settleCycle": "0",
"settleStatus": 0,
"showLegalcerno": "1101011989****147X",
"smallAmount": 1,
"stepFlag": "1.1",
"sysMark": "1",
"tradStatus": 0
}
},
"sign": "ba39885484ad009a761b6dde35ac7b00",
"randomVal": null
}
}
</code></pre>
<h5>成功返回示例的参数说明</h5>
<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;">ret_code</td>
<td style="text-align: left;">object</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">ret_msg</td>
<td style="text-align: left;">object</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object</td>
<td>返回体</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td>返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>返回描述</td>
</tr>
<tr>
<td style="text-align: left;">resultData</td>
<td style="text-align: left;">object</td>
<td>返回数据体</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData</td>
<td style="text-align: left;">object</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.addDate</td>
<td style="text-align: left;">string</td>
<td>添加日期</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.addMerFlag</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.addTime</td>
<td style="text-align: left;">string</td>
<td>添加时间</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.brandNo</td>
<td style="text-align: left;">string</td>
<td>品牌编号</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.buyingPower</td>
<td style="text-align: left;">string</td>
<td>是否有购买权限 0-有、1-无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.channel</td>
<td style="text-align: left;">string</td>
<td>市场类型</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.collectway</td>
<td style="text-align: left;">string</td>
<td>收取方式 0-按笔、1-按费率</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.delayGuarantee</td>
<td style="text-align: left;">string</td>
<td>是否开启延迟保障(1未开启 2已开启)</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.enrollStatus</td>
<td style="text-align: left;">string</td>
<td>进件状态: 1进件结束、2当前步骤完成、3跳转活体提额认证、4跳转信用卡提额认证</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.idCardBackImgUrl</td>
<td style="text-align: left;">string</td>
<td>身份证国徽面图片url</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.idCardFrontImgUrl</td>
<td style="text-align: left;">string</td>
<td>身份证头像面图片url</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.indCategory</td>
<td style="text-align: left;">string</td>
<td>行业类别 默认标准类</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.indMcc</td>
<td style="text-align: left;">string</td>
<td>行业MCC</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.intime</td>
<td style="text-align: left;">string</td>
<td>入库时间</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.isblacklist</td>
<td style="text-align: left;">string</td>
<td>是否黑名单 0-否、1-是</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.ischarge</td>
<td style="text-align: left;">string</td>
<td>是否收取手续费 0-收、1-不收</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.iswhitelist</td>
<td style="text-align: left;">string</td>
<td>是否白名单 0-否、1-是</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalCer</td>
<td style="text-align: left;">string</td>
<td>法人证件 0-身份证、1-护照</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalCerno</td>
<td style="text-align: left;">string</td>
<td>法人证件号码</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalDate</td>
<td style="text-align: left;">string</td>
<td>身份证有效期</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalName</td>
<td style="text-align: left;">string</td>
<td>法人或法人代表姓名</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalNameEnc</td>
<td style="text-align: left;">object</td>
<td>法人或法人代表姓名加密</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalNameEnc.cipherText</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalNameEnc.clearText</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.legalNameEnc.maskText</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.linkEmailEnc</td>
<td style="text-align: left;">object</td>
<td>联系人邮箱加密</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.linkManEnc</td>
<td style="text-align: left;">object</td>
<td>商户联系人</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merBusinessType</td>
<td style="text-align: left;">string</td>
<td>0 对公 1 对私法人 2对私非法人</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merCategory</td>
<td style="text-align: left;">string</td>
<td>商户类别(0-标准类、1-优惠类、2-减免类)</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merLevel</td>
<td style="text-align: left;">string</td>
<td>商户等级:A-Z ;A最低</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merModify</td>
<td style="text-align: left;">string</td>
<td>资料是否修改1_未修改2_已修改</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merName</td>
<td style="text-align: left;">string</td>
<td>商户全称</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merNature</td>
<td style="text-align: left;">string</td>
<td>商户性质(0-企业、1-个人、3-Mpos个人、4-Mpos企业、5-大Pos个人、6-大Pos企业)</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merShortname</td>
<td style="text-align: left;">string</td>
<td>商户简称</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merStatus</td>
<td style="text-align: left;">string</td>
<td><em> 商户状态0-正式、1-停用、2-待提交资质、3-审核中、4-审核打回[退回修改]、5-待绑定终端 6:身份认证[手刷实名认证第一步] 7:结算卡认证[手刷实名认证第二步] 8:绑定店铺[手刷实名认证第三步]9 </em> 企业商户状态-终止审核状态</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merType</td>
<td style="text-align: left;">string</td>
<td>商户类型(0-传统商户、1-手刷(MPOS)商户、2-机构商户、3-闪银Pro)</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merareas</td>
<td style="text-align: left;">string</td>
<td>商户注册gps地址[省市区]</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merdetailedaddress</td>
<td style="text-align: left;">string</td>
<td>商户注册详细gps地址</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.merno</td>
<td style="text-align: left;">string</td>
<td>商户编号</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.posNumber</td>
<td style="text-align: left;">string</td>
<td>绑定终端数量</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.settleCycle</td>
<td style="text-align: left;">string</td>
<td>结算周期 0:D0 1:T1</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.settleStatus</td>
<td style="text-align: left;">string</td>
<td>结算状态 -1 手动(人工解冻) 0-开通、1-自动(解冻)</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.showLegalcerno</td>
<td style="text-align: left;">string</td>
<td>展示身份证号</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.smallAmount</td>
<td style="text-align: left;">string</td>
<td>是否开启小额双免(1未开通 2开通)</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.stepFlag</td>
<td style="text-align: left;">string</td>
<td>商户进件标识,下一步是几第步</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.sysMark</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">resultData.realData.tradStatus</td>
<td style="text-align: left;">string</td>
<td>交易状态 0-开通、1-禁用</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string</td>
<td>无</td>
</tr>
<tr>
<td style="text-align: left;">randomVal</td>
<td style="text-align: left;">object</td>
<td>无</td>
</tr>
</tbody>
</table>