## **商戶進件** ## 請求地址：/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. 若接口中有用不到的參數，則不要傳遞此參數，請勿對參數傳空值。