三、新增商户 - Powered by MinDoc

接口描述：

新增商户信息接口文档

接口版本：

版本号	制定人	制定日期	修订日期
1.0.0	高俭	2020-04-29	2020-04-29

请求URL:

https://sspaytest.xrtpay.cn/api/add_mch

请求方式：

POST

请求头：

参数名	是否必须	类型	说明
Content-Type	是	String	请求类型： application/json

请求参数:

参数名	变量名	类型	是否必须	说明
渠道号	agentno	string	M	渠道商编号
随机字符串	nonce_str	string	M	32位随机字符串
签名	sign	string	M	签名字符串
签名类型	sign_type	string	O	签名算法类型默认MD5
商户类型	merType	string	M	0：MPOS（手刷）；1：POS（传统）
注册手机号	mobileNumber	string	M	注册的手机号或者邮箱（不可重复）（加密字段）
商户名称	name	string	M	注册地址所属省
注册地址所属省	registerProvince	string	M	注册省名全称如浙江省
注册地址所属市	registerCity	string	M	注册市名全称如杭州市
注册地址所属区	registerArea	string	M	注册区名或县名全称如西湖区
注册地址	registerAddr	string	M
注册资本	regCapital	string	M	单位：万元
注册登记号	registerNo	string	C	工商注册号（不可重复）merPro =1 或 2 时，必传
营业执照有效期始	busliceStartDate	string	C	格式：yyyy-MM-dd，merPro=1 或 2，必传
营业执照有效期止	busliceEndDate	string	C	格式：yyyy-MM-dd merPro=1 或 2，必传
营业执照注册名称	busliceRegName	string	C	merPro=1 或 2，必传
法人姓名	legalName	string	C	merPro=1 或 2，必传（加密字段）
法人证件类型	legalCertType	string	C	01：身份证，02：户口本，03护照 merPro=1 或 2，必传
法人证件号码	legalCertCode	string	C	merPro=1 或 2，必传（加密字段）
法人联系人手机	linkManPhone	string	M	（加密字段）
联系人姓名	linkManName	string	M	（加密字段）
联系人邮箱	linkManEmail	string	M	注：此处应填交易卡号（信用卡）（加密字段）
调单联系人姓名	dLinkManName	string	O	（加密字段）
调单联系人手机	dLinkManMobileNo	string	O	（加密字段）
商户性质	merPro	string	C	1：个体 2：企业 merType=1，必传
商户 MCC	mcc	string	M	MCC 码
经营业务	runBusiness	string	O	如服装零售，餐饮，住宿等
结算方式	settleMethod	string	M	01：T1，02：D0，03：D1，注：目前只支持D0
结算账户类型	settleAccType	string	M	0：对公；1：对私
结算账号户名	settleAccName	string	M	（加密字段）
结算账号	settleAccNo	string	M	注：此次应填入账卡号（借记卡）（加密字段）
结算账号身份证号	settleAccIdCard	string	M	（加密字段）
结算银行支行名称	settleBranchBank	string	M
结算支行联行号	bankBranchNo	string	M
门店信息	shopInfo	string	M	每个商户支持多个门店，字段值为 json 数组的形式，具体字段见附表一
借记卡费率封顶值	debitUpperLimit	string	M	单位（分）
借记卡费率	debitFeeRate	string	M	例：千分之五为 0.0050000，支持七位小数
贷记卡费率	creditFeeRate	string	M	例：千分之五为 0.0050000，支持七位小数
境外借记卡费率	overseaDebitFeeRate	string	O	例：千分之五为 0.0050000，支持七位小数
境外贷记卡费率	overseaCreditFeeRate	string	O	例：千分之五为 0.0050000，支持七位小数
银联二维码费率	cupQrFeeRate	string	O	例：千分之五为 0.0050000，支持七位小数
支付宝费率	alipayQrFeeRate	string	O	例：千分之五为 0.0050000，支持七位小数
微信费率	wechatQrFeeRate	string	O	例：千分之五为 0.0050000，支持七位小数
清算服务费	serviceFee	string	O	单位（分）
商户级别	merLevel	string	M	商户的级别（1：A 级，2：B 级，3：C 级）
红盾网链接	redShieldQualityUrl	string	C	merLevel=1 或 2 时，必传
营业执照照片	busLicPath	string	C	营业执照照片路径 merPro=1 或 2，必传
身份证照片	identityImgPath	string	M	身份证正面照路径
店面门头照片	mtAPath	string	C	店面门头照片路径 merPro=1 或 2，必传
店面收银台照片	mtBPath	string	C	店面收银台照片路径 merPro=1 或 2，必传
店面场景照片	mtCPath	string	C	店面场景照片路径 merPro=1 或 2，必传
结算账户照片	bankImgPath	string	M	结算账户照片路径
商户签约合同	contractPath	string	C	商户签约合同和商户入网协作路径 merLevel =1 或 2，必传
其他附件	otherPath	string	O	除上述照片外的资料，通过 3.1 获取路径（如：商户非法人结算授权书）
商户清算类型	pay_type	int	O	商户清算类型，1-直清模式， 2-代付模式不传默认为代付模式

附表一：

门店信息 shopInfo
shopInfo 子域采用嵌套 JSON 格式，全部内容用“{ }”包含，内部可包含多个字段，字段定义如下表：

参数名	变量名	类型	是否必须	说明
门店名称	shopName	string	M
门店地址	shopAddr	string	M
门店联系人	shopLinkManName	string	O
门店联系人电话	shopLinkManPhone	string	O
pos 安装省	shopProvince	string	M	注册省名全称如浙江省
pos 安装市	shopCity	string	M	注册市名全称如杭州市
终端信息	termInfo	string	O	每个门店支持多个 pos，字段值为 json 数组的形式，具体字段见附表二，例如:“copId”：”000031”，“trmmodNo”：”700” ， “posSerialNo”：”1234523” }，{ “copId”：”000031” ， “trmmodNo”：” 700” ， “posSerialNo”：”1234523”}]

附表二:

门店信息 pos
pos 子域采用嵌套 JSON 格式，全部内容用“{ }”包含，内部可包含多个字段，字段定义如下表：

参数名	变量名	类型	是否必须	说明
终端厂商编号	copId	string	C	000031：福建魔方 000002：百富 000006：华智融 000012：实达 000003：新大陆
POS 型号	termModNo	string	C
POS 序列号	posSerialNo	string	C	8 位以上数字或字母（不可重复）

请求示例:

{
    "agentno":"8110123456",
    "nonce_str":"hhjjwwjjuu7766522ju765dgt543256h",
    "sign":"A03D5B6078FB513D8CBBFF5B0E865DCA",
    "registerCity": "北京",
    "dLinkManName": "高先生",
    "busLicPath": "3137fc2869729944ea3e52b5d068a33d",
    "mtBPath": "3137fc2869729944ea3e52b5d068a33d",
    "creditFeeRate": "0.00540",
    "regCapital": "100",
    "mobileNumber": "13699899888",
    "busliceRegName": "服务商1测试",
    "mcc": "4225",
    "mtAPath": "3137fc2869729944ea3e52b5d068a33d",
    "mtCPath": "3137fc2869729944ea3e52b5d068a33d",
    "registerNo": "188115429291222",
    "redShieldQualityUrl": "www.baidu.com",
    "legalName": "高先生",
    "merLevel": "2",
    "registerAddr": "酒仙桥",
    "settleMethod": "01",
    "busliceStartDate": "2018-01-01",
    "settleAccType": "1",
    "linkManPhone": "13899998888",
    "shopInfo": "[{\"termInfo\":[{\"copId\":\"000031\",\"termModNo\":\"MF68\",\"posSerialNo\":\"12344415\"}],\"shopAddr\":\"北京市朝阳区西坝河西里6号楼509号\",\"shopCity\":\"龙岩\",\"shopLinkManName\":\"服务商1\",\"shopLinkManPhone\":\"17845496525\",\"shopName\":\"服务商1测试\",\"shopProvince\":\"福建省\"}]",
    "debitFeeRate": "0.00410",
    "legalCertCode": "430426199102100006",
    "busliceEndDate": "2020-01-01",
    "settleAccNo": "11220000999988886666",
    "registerProvince": "北京市",
    "settleAccName": "高老师",
    "linkManName": "高老师",
    "bankImgPath": "3137fc2869729944ea3e52b5d068a33d",
    "dLinkManMobileNo": "13599880077",
    "debitUpperLimit": "1700",
    "settleAccIdCard": "430426199102100006",
    "merPro": "1",
    "bankBranchNo": "305100001660",
    "name": "服务商1测试",
    "settleBranchBank": "中国民生银行股份有限公司北京回龙观支行",
    "merType": "1",
    "identityImgPath": "3137fc2869729944ea3e52b5d068a33d",
    "registerArea": "朝阳区",
    "legalCertType": "01",
    "contractPath": "3137fc2869729944ea3e52b5d068a33d"
}

返回示例:

正确时返回:

{
    "code": "0000",
    "data": {
        "agentno": "8110123456",
        "merId": "881100042250120",
        "nonce_str": "11hjh3h4g5g4g3b4b5b6b43vg2bgt343",
        "sign": "B3FAFCFC7717BA68ED5A623BA26DB36D",
        "termId": "{\"19877656672\":\"G0000094\"}"
    },
    "msg": "处理成功"
}

错误时返回:

{
    "code": "4000",
    "msg": "处理失败"
}

返回参数说明:

参数名	变量名	类型	说明
状态码	code	string	0000为成功，其他都为失败
状态描述	msg	string	状态描述
返回数据详情	data	JsonObject	返回数据详情
渠道号	agentno	string	渠道商编号
随机字符串	nonce_str	string	32位随机字符串
签名	sign	string	签名字符串
商户编号	merId	string	只有状态码是成功时才返回（收单机构自定义商编，以审核通知 cupMerId 商编为准）
终端编号	termId	string	键值对形式，key 为 POS 序列号，值为 POS 终端编号（成功时返回）

备注:

更多返回错误代码请看附录的错误代码描述

文档更新时间: 2020-11-03 17:34 作者：高俭