## **商户进件** ##
请求地址：/api/merchant/register
**输入参数**
|分类|参数名称|类型|长度限制|是否必填|说明|
|:---|:---|:---|:---|:---|:---|
|baseInfo<br>(商户基本信息)|merchantType|Integer|1|O|商户类型会根据有无营业执照编号自动判断1:个人3:企业|
||merchantName|String|2-20|M|商户简称（不有特殊字符）|
||servicePhone|String|20|O|客服电话（如075586010000,不能带–）|
||mccCode|String|4|M|MCC码商户行业编号(按银联标准)|
|legalPerson<br>(法人信息，个人类型填联系人信息)|legalName|String|10|M|法人姓名|
||credentialType|Integer|1|O|证件类型：1-身份证；2-港澳台通行证；3-台湾身份证；4-香港身份证；5-澳门身份证；9-其它法定文件(不传默认身份证)|
||idCardNo|String|18|M|证件号码|
||idcardFrontPic|String|无|M|法人身份证正面|
||idcardBackPic|String|无|M|法人身份证反面|
||idcardHandPic|String|无|C|手持身份证照|
|| idCardStart|String|无|M|证件有效期开始日期
||idCardEnd|String|无|M|证件有效期结束格式： 2015-09-22，永久有效:2099-12-30|
|contactInfo<br>(联系人信息)|name|String|10|M|联系人姓名|
||mobile|String|11|M|手机号码（11位手机号）|
|addressInfo<br>(店铺地址信息)|province|String|32|M|省|
||city|String|32|M|市|
||area|String|32|M|区县|
||address|String|5-40|M|商户详细地址|
|licenseInfo<br>(营业资质信息)|license|String|18|C|营业执照注册号(企业必填)|
||licenseFullName|String|40|M|企业类填写：营业执照名称，执照如无名称，可填“个体户XXX”（执照上姓名）；小微商户填“商户_XXX”（身份证姓名）|
||licenseAddress|String|无|C|营业执照注册地址(企业必填)|
||licenseStart|String|32|C|营业执照注册号开始日期(企业和个体有营业执照必填)格式：2015-09-22|
||licenseEnd|String|32|C|营业执照注册结束日期(企业和个体有营业执照必填)格式：2015-09-22，永久有效:2099-12-30|
||licensePic|String|无|C|营业执照照片|
|accountInfo<br>(结算信息)|legalFlag|Integer|1|M|0：非法人结算1：法人结算|
||type|Integer|1|M|1：个人账户；2：公司账户|
||branch|String|20|C|开户行网点(与联行号二选一必传)|
||unionpay|String|20|C|开户支行联行号(企业必传)|
||holder|String|无|M|开户名；法人结算：与法人姓名姓名一致；企业账户：与营业执照注册名称一致|
||idCardNo|String|18|C|结算人身份证号码(个人账户必传)|
||mobile|String|11|O|银行预留号码|
||bankCardNo|String|24|M|银行卡号|
||bankCardFrontPic|String|无|M|银行卡正面（如是对公账户，开户许可证）|
||nonLegSettleAuthPic|String|无|C|非法人结算授权书(非法人结算模式必传)|
||nonLegIdcardFrontPic|String|无|C|非法人身份证正面(非法人结算模式必传)|
||nonLegIdcardBackPic|String|无|C|非法人身份证背面(非法人结算模式必传)|
|shopInfo<br>(门店信息)|shopType|Integer|1|O|店铺类型（默认为总店）；1总店 0分店|
||headMerchantId|String|10|C|总店商户号，分店必填|
||settleTo|Integer|10|C|结算对象，分店必传；默认结算给当前商户，0表示结算给当前商户，1表示结算给总店；|
||insidePic|String|无|M|经营场所内设照片|
||doorPic|String|无|M|门头照|
||cashierDeskPic|String|无|M|收银台照片|
|wechatInfo<br>(微信信息)|userWx|String|无|O|联系人微信号|
||subAppid|String|18|O|微信公众号支付appid|
||jsapiPath|String|无|O|微信公众号授权目录(最多5个，使用半角英文;隔开)|
||subscribeAppid|String|18|O|微信公众号支付完成后推荐关注appid(此处的推荐关注对应上方支付appid)|
|otherInfo<br>（其它信息）|reportConfigId|Integer|11|O|上报需要的配置信息|
||notifyAddress|String|无|O|交易异步回调地址(建议在交易接口传，此处只作为备用)|
||protocolPagePic|String|无|O|商户协议照|
**注**：
M：must，必须；
C：condition，条件必填；
O：option，可选；
**请求示例**
```
{
"baseInfo": {
"merchantType": 2,
"merchantName": "欢乐时光",
"servicePhone": "07558610666",
"mccCode": "5812"
},
"legalPerson": {·
"legalName": "张三",
"idCardNo": "110110199909099119",
"idcardFrontPic": "picture2/M00/A4/6F/wKgLeVvOgU-AYjzwAAOqYwzy-i4992.jpg",
"idcardBackPic": "picture2/M00/A4/71/wKgLeVvOgWiAXKG7AAZvey6bCkE149.jpg"
},
"contactInfo": {
"name": "张三",
"mobile": "18888888888"
},
"addressInfo": {
"province": "广东省",
"city": "深圳市",
"area": "南山区",
"address": "商户地址信息"
},
"licenseInfo": {
"license": "91441222311952279K",
"licenseFullName": "深圳市测试有限公司",
"licenseAddress": "深圳市南山区测试",
"licenseStart": "2015-09-22",
"licenseEnd": "2099-12-30",
"licensePic": "picture2/M00/A4/77/wKgLeVvOgZCAcV_jAAGC3h6c7wY569.jpg"
},
"accountInfo": {
"legalFlag": 1,
"type": 1,
"unionpay": "307584021099",
"holder": "张三",
"idCardNo": "110110199909099119",
"mobile": "18866666666",
"bankCardNo": "6212264000055964882",
"bankCardFrontPic": "picture2/M00/A4/73/wKgLeVvOgXqAUFdHAAFRVRj6CF0408.jpg",
"nonLegSettleAuthPic": "picture2/M00/A4/81/wKgLeVvOgeWAYVGBAAzohQRanw8313.png",
"nonLegIdcardFrontPic": "picture2/M00/A4/81/wKgLeVvOgeWAYVGBAAzohQRanw8313.png",
"nonLlegIdcardBackPic": "picture2/M00/A4/81/wKgLeVvOgeWAYVGBAAzohQRanw8313.png"
},
"shopInfo": {
"insidePic": "picture2/M00/A4/7D/wKgLeVvOgcOAVC_WAAAJsWNG9U8667.jpg",
"doorPic": "picture2/M00/A4/79/wKgLeVvOgaaABeKoAAAp_2wyyQc022.jpg",
"cashierDeskPic": "picture2/M00/A4/81/wKgLeVvOgeWAYVGBAAzohQRanw8313.png"
},
"wechatInfo": {},
"otherInfo": {}
}
```
**输出参数**
|**参数名称**|**类型**|**长度限制**|**是否必填**|**说明**|
|:---|:---|:---|:---|:---|
|merchantId|String|10|M|商户ID|
|username|String|32|M|商户账号|
```
{
"respCode": "成功",
"reqSerialNo": "2017062300000001",
"version": "1.0",
"data": {
"merchantId": "1234567890",
"username": "LS1234567890"
}
}
```
**注意事项**
1. 微信参数wechatInfo字段，subAppid和subscribeAppid只能配置一个，如需额外配置，请使用微信支付参数配置接口。
2. 进件成功后商户会自动上报上游，因上游限制营业执照全称、客服电话等部分信息不能修改，所以请务必在进件时保证参数准确。
3. 若接口中有用不到的参数，则不要传递此参数，请勿对参数传空值。
- 产品介绍
- 1、概述
- 2、变更记录
- 应用场景
- 进件应用场景
- 交易应用场景
- 对账应用场景
- 交易错误码信息参照表
- 进件接口
- 接口指南及签名算法等说明
- 图片上传
- 商户进件
- 商户开通业务
- 商户信息修改
- 商户查询
- 商户支付参数-新增
- 商户支付参数-查询
- 商户审核回调
- 子商户号查询
- 商户微信实名认证-申请
- 商户微信实名认证-撤销
- 商户微信实名认证-查询
- 交易接口
- 数据格式及签名规则说明
- 统一下单
- 条码支付
- 交易结果查询
- 订单关闭
- 退款
- 退款查询
- 授权码查询用户openid
- 授权码获取银联云闪付用户ID
- 退款结果通知
- 支付结果通知
- 打款查询
- 商户打款单结果查询
- 查询商户指定日期打款情况
- 查询旗下商户打款失败明细
- 打款回调
- 对账单文件
- 交易对账单
- 代理商分润对账单
- 代理商退货分润对账单
- 商户打款单
- POS机具通知
- 数据格式及数据签名说明
- 扫码支付成功通知
- 扫码退款通知
- 刷卡交易通知
- FAQ
- 进件相关
- 交易相关
- POS相关
- 手续费及分润计算
- Demo相关下载
- Demo与进件相关数据和对账单文件示例下载
- Java-SDK使用说明
- 商户进件资料提交规范
- 商户信息提交规范
- 商户结算信息提交规范
- 图片上传提交规范
- 结算
- 常见打款失败原因
- 商户修改结算卡流程
- 商户特殊业务
- 商户申请关注公众号
- 商户申请手续费开票流程
- 机具购买流程
- saasPOS机具清单信息
- 服务商机具购买流程
- saas刷脸设备清单信息
- 商户微信认证操作指引
- 商户微信认证操作指引
- 重要通知