商家入驻 - Powered by MinDoc

创建商户号

通过该接口注册友联Plus系统商户号

接口说明

适用对象： 特约商户

请求URL： https://merapi.zfiot.net/api/mchApplyments/createMchNo

请求方式： POST

请求类型： application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
代理商号	agentNo	是	String(30)	A1720421400	代理商号，友联plus分配
商户名称	mchName	是	String(32)	商户名称	企业、个体工商户：营业执照上的工商注册名称个人小微商户：商户XX(经营者姓名)
商户简称	mchShortName	是	String(32)	商户简称	商户简称
联系人姓名	contactName	是	String(32)	张三	联系人姓名
联系人手机号	contactTel	是	String(32)	13000000000	联系人手机号
联系人邮箱	contactEmail	否	String(32)	test@test.com	联系人邮箱
登录用户名	loginUsername	是	String(11)	13000000000	用于登录商家系统，建议填写手机号，系统唯一
请求时间	reqTime	是	Number(20)	1622016572190	请求接口时间，13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	String(10)	0	0-处理成功，其他-处理有误，详见返回码
返回信息	msg	否	String(128)	签名失败	具体错误原因
签名信息	sign	否	String(32)	9B4AAE1DADC5A4281B1D165C941A1BE6	对data内数据签名，如data为空则不返回
返回数据	data	否	String(512)	{}	响应实体，使用json格式数据返回具体业务参数

data数据格式

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
默认应用ID	appId	是	String(24)	66ad9861d5def240e7f35e2e	默认应用ID

返回示例数据

                                            
{
    "code":0，
    "data":{
        "appId":"66ac7b47d5dea09dc4df2eb3"，
        "mchNo":"M1722652769"
    }，
    "msg":"SUCCESS"，
    "sign":"B4B27544669CB86EEF68C8D05BAA7B14"
}

商户开通产品

通过该接口开通商家的支付产品以及设置费率。

接口说明

适用对象： 特约商户

请求URL： https://merapi.zfiot.net/api/mchApplyments/paySetting

请求方式： POST

请求类型： application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
应用ID	appId	是	String(24)	66ad9861d5def240e7f35e2e	应用ID
开通产品和费率	paywayFees	是	String(512)	[{"wayCode":"WX_JSAPI"，"feeType":"SINGLE"，"feeRate":0.006}， {"wayCode":"ALI_JSAPI"，"feeType":"SINGLE"，"feeRate":0.006}]	开通产品以及费率，Json格式数组，详见paywayFees详情
请求时间	reqTime	是	Number(20)	1622016572190	请求接口时间，13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5

paywayFees详情

字段名	变量名	必填	类型	示例值	描述
支付产品	wayCode	是	String(20)	WEB_CASHIER	开通的支付产品，参考支付方式
收费方式	feeType	是	String(20)	SINGLE	收费方式，暂只支持比例收费，使用默认值：SINGLE
费率值	feeRate	否	Number	0.006	费率值，支持小数点后4位

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	String(10)	0	0-处理成功，其他-处理有误，详见返回码
返回信息	msg	否	String(128)	签名失败	具体错误原因
签名信息	sign	否	String(32)	9B4AAE1DADC5A4281B1D165C941A1BE6	对data内数据签名，如data为空则不返回
返回数据	data	否	String(512)	{}	响应实体，使用json格式数据返回具体业务参数

data数据格式

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
应用ID	appId	是	String(24)	66ad9861d5def240e7f35e2e	应用ID

返回示例数据

                                            
{
    "code":0，
    "data":{
        "appId":"66ac7b47d5dea09dc4df2eb3"，
        "mchNo":"M1722652769"
    }，
    "msg":"SUCCESS"，
    "sign":"B4B27544669CB86EEF68C8D05BAA7B14"
}

支付方式

WayCode	支付方式
WEB_CASHIER	WEB收银台
QR_CASHIER	聚合扫码(用户扫商家)
AUTO_BAR	聚合条码(商家扫用户)
ALI_BAR	支付宝条码
ALI_JSAPI	支付宝生活号
ALI_LITE	支付宝小程序
ALI_QR	支付宝二维码
WX_BAR	微信条码
WX_JSAPI	微信公众号
WX_LITE	微信小程序

上传图片

通过该接口上传商家的一些证件，资质等图片，该接口不参与签名。

接口说明

适用对象： 特约商户

请求URL： https://merapi.zfiot.net/api/mchApplyments/uploadPic

请求方式： POST

请求类型： multipart/form-data

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
文件	file	是	MultipartFile		图片支持JPG、PNG、JPEG格式，文件大小不能超过5M

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	String(10)	0	0-处理成功，其他-处理有误，详见返回码
返回信息	msg	否	String(128)	签名失败	具体错误原因
返回数据	data	否	String(512)	{}	响应实体，使用json格式数据返回具体业务参数

data数据格式

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
图片资源ID	mediaId	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	图片资源ID

返回示例数据

                                        
{
    "code":0，
    "data":{
        "mediaId":"a77abae3-4213-4db1-a01e-d4716fb74ed2_API"，
        "mchNo":"M1722652769"
    }，
    "msg":"SUCCESS"
}

商家信息进件

提供商家的联系人，法人，结算等信息进行进件。

接口说明

适用对象： 特约商户

请求URL： https://merapi.zfiot.net/api/mchApplyments/incoming

请求方式： POST

请求类型： application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
应用appid	appId	是	String(24)	66ad9861d5def240e7f35e2e	应用appid
商户申请流水号	mchApplyId	是	String(64)	A2024080302	商户申请流水号，相同流水号重复请求代表修改信息重新进件
商户类型	mchType	是	String(1)	1	商户类型： 1:个人商户，也即小微商户； 2:个体工商户； 3:企业商户；
小微经营类型	microBizType	否	String(20)	MICRO_TYPE_STORE	小微经营类型，个人商户必传； MICRO_TYPE_STORE : 门店场所 MICRO_TYPE_MOBILE : 流动经营/便民服务 MICRO_TYPE_ONLINE : 线上商品/服务交易
商户名称	mchFullName	是	String(32)	商户名称	企业、个体工商户：营业执照上的工商注册名称个人小微商户：商户XX(经营者姓名)
商户简称	mchShortName	是	String(16)	商户简称	商户简称
营业执照编号	licenseNo	否	String(32)	92320581MA7MPR1O6L	营业执照编号，个体和企业必填
营业执照图片资源ID	licenseImg	否	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	营业执照图片资源ID，个体和企业必填
营业执照注册地址	licenseAddress	否	String(256)	上海市黄浦区新码头街55号4幢3444楼	营业执照注册地址，个体和企业必填
营业执照有效期开始时间	licenseEffectBegin	否	String(20)	2019-08-28	营业执照有效期开始时间，格式YYYY-MM-DD，个体和企业必填
营业执照有效期截止时间	licenseEffectEnd	否	String(20)	2049-08-27	营业执照有效期截止时间，格式YYYY-MM-DD，有效期为长期，则填长期，个体和企业必填
法人身份证姓名	idcardName	是	String(32)	测试	法人身份证姓名
法人身份证号	idcardNo	是	String(20)	310102191234534449	法人身份证号
法人身份证人像面	idcard1Img	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	法人身份证人像面图片资源ID
法人身份证国徽面	idcard2Img	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	法人身份证国徽面图片资源ID
法人身份证地址	idcardAddress	是	String(100)	广东省深圳市	法人身份证地址
法人身份证有效期开始时间	idcardEffectBegin	是	String(20)	2019-08-28	法人身份证有效期开始时间，格式YYYY-MM-DD
法人身份证有效期截止时间	idcardEffectEnd	是	String(20)	2039-08-28	法人身份证有效期截止时间，格式YYYY-MM-DD，有效期为长期，则填长期
法人手机号	legalPersonPhone	是	String(20)	13000000000	法人手机号
联系人类型	contactType	是	String(1)	A	联系人类型 A:经营者/法人 B:经办人
联系人姓名	contactName	否	String(20)	测试	联系人姓名，联系人类型为经办人时必填
联系人电话	contactPhone	否	String(220)	18888888888	联系人电话，联系人类型为经办人时必填
联系人邮箱	contactEmail	是	String(30)	test@test.com	联系人邮箱
联系人身份证号码	contactIdcardNo	否	String(20)	310102191234534449	联系人身份证号码，联系人类型为经办人时必填
联系人身份证地址	contactIdcardAddress	否	String(100)	广东省深圳市	联系人身份证地址，联系人类型为经办人时必填
联系人身份证有效期起始日期	contactIdcardEffectBegin	否	String(20)	2019-08-28	联系人身份证有效期起始日期，格式YYYY-MM-DD，联系人类型为经办人时必填
联系人身份证有效期结束日期	contactIdcardEffectEnd	否	String(20)	2039-08-28	联系人身份证有效期结束日期，格式YYYY-MM-DD，有效期为长期，则填长期，联系人类型为经办人时必填
联系人身份证正面照	contactIdcard1Img	否	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	联系人身份证正面照资源ID，联系人类型为经办人时必填
联系人身份证反面照	contactIdcard2Img	否	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	联系人身份证反面照资源ID，联系人类型为经办人时必填
银联mcc码	mccCode	是	String(10)	57915982ds	银联mcc码，参考银联mcc码.xlsx文档
经营类目	businessCategory	是	String(32)	OFFLINE_RETAIL-384	经营类目，参考经营子类编码V2.0.xlsx文档，使用大类-小类的方式，示例:线下百货行业，传OFFLINE_RETAIL-384
经营内容描述	licenseBusiness	是	String(100)	测试	经营内容描述
门头照	storeOuterImg	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	门头照资源ID
收银台照片	storeCashierImg	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	收银台照片资源ID
店内环境照片	storeInnerImg	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	店内环境照片资源ID
经营地省市区	areaCode	是	String(40)	[\"广东省\"，\"深圳市\"，\"罗湖区\"]	经营地省市区，示例:[\"广东省\"，\"深圳市\"，\"罗湖区\"]，使用JSON数组格式，参考省市区编码表.xlsx文档
经营详细地址	address	是	String(100)	广东省深圳市	经营详细地址
经度	latitude	是	String(10)	30.000000	经度
纬度	longtude	是	String(10)	31.123000	纬度
网站地址	webSite	否	String(50)	www.zfiot.net	网站地址
结算账号类型	settAccountType	是	String(1)	C	结算账号类型 C:对私;B对公
结算账号名称	settAccountName	是	String(32)	测试	结算账号名称
结算银行卡账号	settAccountNo	是	String(20)	62245885235821	结算银行卡账号
结算照片资源	settAccountLicenseImg	是	String(32)	57915982-5c96-4848-882f-ac8e414a11b6_API	对私传银行卡照片资源ID，对公传开户许可证照片资源ID
联行号	openningBankCode	是	String(32)	102100005374	联行号，参考联行号.xlsx文档
协议照片	agreeMentImg	否	String(100)	57915982-5c96-4848-882f-ac8e414a11b6_API	协议照片
法人授权函照片	letterOfAuthorizationImg	否	String(100)	57915982-5c96-4848-882f-ac8e414a11b6_API	法人授权函照片
结算人是否为法人	isLegalInfo	是	String(1)	1	结算人是否为法人，1:是，0否
结算卡持卡人身份证号	settAccountIdcardNo	否	String(100)	310102191234534449	结算卡持卡人身份证号，非法人结算时必填
结算卡身份证人像面照片	settAccountIdcard1Img	否	String(100)	57915982-5c96-4848-882f-ac8e414a11b6_API	结算卡身份证人像面照片资源ID，非法人结算时必填
结算卡身份证国徽面照片	settAccountIdcard2Img	否	String(100)	57915982-5c96-4848-882f-ac8e414a11b6_API	结算卡身份证国徽面照片资源ID，非法人结算时必填
结算卡身份证有效期开始时间	settAccountIdcardEffectBegin	否	String(20)	2019-08-28	结算卡身份证有效期开始时间，格式YYYY-MM-DD，非法人结算时必填
结算卡身份证有效期截止时间	settAccountIdcardEffectEnd	否	String(20)	2039-08-28	结算卡身份证有效期截止时间，格式YYYY-MM-DD，有效期为长期，则填长期，非法人结算时必填
请求时间	reqTime	是	Number(20)	1622016572190	请求接口时间，13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	String(10)	0	0-处理成功，其他-处理有误，详见返回码
返回信息	msg	否	String(128)	签名失败	具体错误原因
签名信息	sign	否	String(32)	9B4AAE1DADC5A4281B1D165C941A1BE6	对data内数据签名，如data为空则不返回
返回数据	data	否	String(512)	{}	响应实体，使用json格式数据返回具体业务参数

data数据格式

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
应用ID	appId	是	String(64)	66ad9861d5def240e7f35e2e	应用ID
系统进件流水号	applyId	是	String(64)	A2024080302	系统进件流水号
进件状态	state	是	String(1)	1	进件状态: 1-审核中 2-进件成功 3-驳回待修改 5-待签约
驳回原因	detailInfo	否	String(128)	测试	驳回原因

返回示例数据

                                        
{
    "code":0，
    "data":{    "applyId":"A1819272950290706434"，
                "appId":"66ac7b47d5dea09dc4df2eb3"，
                "state":1，
                "mchNo":"M1722652769"
            }，
    "msg":"SUCCESS"，
    "sign":"D36A65BD9623A44DAD47B9E1115DB397"      
}

商家信息进件结果查询

查询进件结果。

接口说明

适用对象： 特约商户

请求URL： https://merapi.zfiot.net/api/mchApplyments/channelState

请求方式： POST

请求类型： application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mchNo	是	String(32)	M1722652769	商户号
应用ID	appId	是	String(32)	66ad9861d5def240e7f35e2e	应用ID
商家申请流水号	mchApplyId	否	String(64)	A2024080302	商家申请流水号和系统申请流水号二选一必填
系统申请流水号	applyId	否	String(64)	A2024080302	系统申请流水号和商家申请流水号二选一必填
请求时间	reqTime	是	Number(20)	1622016572190	请求接口时间，13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	String(10)	0	0-处理成功，其他-处理有误，详见返回码
返回信息	msg	否	String(128)	签名失败	具体错误原因
签名信息	sign	否	String(32)	9B4AAE1DADC5A4281B1D165C941A1BE6	对data内数据签名，如data为空则不返回
返回数据	data	否	String(512)	{}	响应实体，使用json格式数据返回具体业务参数

data数据格式

字段名	变量名	必填	类型	示例值	描述
系统流水号	applyId	是	String(1)	66ac7b47d5dea09dc4df2eb3	系统流水号
商家申请流水号	mchApplyId	是	String(10)	A2024080202	商家申请流水号
商户号	mchNo	是	String(32)	M1722652769	商户号
应用ID	appId	是	String(32)	66ad9861d5def240e7f35e2e	应用ID
进件状态	state	否	String	1	进件状态: 1-审核中 2-进件成功 3-驳回待修改 5-待签约
电子签约链接	signUrl	否	String(128)	https://8g.cn/h2dqj	电子签约链接，状态为待签约时返回
微信商家认证链接	wxAuthUrl	否	String(128)	https://merchant.jlpay.com/web/business_license?file_url=group2%2FM04%2FED%2F69%2FCgIZAmawe-SAccAGAAAtqjGBRv0335.png	微信商家认证链接
支付宝商家认证链接	aliAuthUrl	否	String(128)	https://mobilecodec.alipay.com/show.htm?code=2ie17192fshnq4nvgcnuj22	支付宝商家认证链接
进件状态描述	detailInfo	否	String(128)	测试	进件状态描述

返回示例数据

                                        
{
    "code":0，
    "data":{
        "appId":"66ac7b47d5dea09dc4df2eb3"，
        "applyId":"A1819272950290706434"，
        "mchApplyId":"A2024080202"，
        "mchNo":"M1722652769"，
        "state":3
    }，
    "msg":"SUCCESS"，
    "sign":"8098917030692DFC8BA1660E2539407C"
}

微信支付参数配置

通过该接口配置微信支付参数。

接口说明

适用对象： 特约商户

请求URL： https://merapi.zfiot.net/api/mchApplyments/wechatParamConf

请求方式： POST

请求类型： application/json 或 application/x-www-form-urlencoded

请求参数

字段名	变量名	必填	类型	示例值	描述
系统进件流水号	applyId	是	String(64)	A2024080302	系统进件流水号
请求流水号	orderNo	是	String(64)	A2024080302	请求流水号
微信公众号appid或者小程序appid	wxAppId	是	String(5)	wx08b5a41f7a27abf1	微信公众号appid或者小程序appid
支付目录	payCatalog	是	String(10)	https://merapi.zfiot.net/	支付目录
关注的公众号	receiptAppId	是	String()	wx08b5a41f7a27abf1	关注的公众号，填写与wxAppId相同即可
商户号	mchNo	是	String(32)	M1722652769	商户号
应用ID	appId	是	String(24)	66ad9861d5def240e7f35e2e	应用ID
请求时间	reqTime	是	Number(20)	1622016572190	请求接口时间，13位时间戳
接口版本	version	是	String(3)	1.0	接口版本号，固定：1.0
签名	sign	是	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名值，详见签名算法
签名类型	signType	是	String(32)	MD5	签名类型，目前只支持MD5

返回参数

字段名	变量名	必填	类型	示例值	描述
返回状态	code	是	String(10)	0	0-处理成功，其他-处理有误，详见返回码
返回信息	msg	否	String(128)	签名失败	具体错误原因
签名信息	sign	否	String(32)	9B4AAE1DADC5A4281B1D165C941A1BE6	对data内数据签名，如data为空则不返回
返回数据	data	否	String(512)	{}	响应实体，使用json格式数据返回具体业务参数

data数据格式

字段名	变量名	必填	类型	示例值	描述
系统进件流水号	applyId	是	String(64)	A1819272950290706434	系统进件流水号
请求流水号	orderNo	是	String(64)	A20240802001	请求流水号
商户号	mchNo	是	String(32)	M1722652769	商户号
应用appid	appId	是	String(24)	66ad9861d5def240e7f35e2e	应用appid

返回示例数据

                                        
{
    "code":0，
    "data":{
        "applyId":"A1819272950290706434"，
        "orderNo":"A20240802001"，
        "mchNo":"M1722652769"，
        "appId":"66ad9861d5def240e7f35e2e"
    }，
    "msg":"SUCCESS"
    "sign":"8098917030692DFC8BA1660E2539407C"
}

返回码

code	描述
0	通讯成功
9999	异常，具体错误详见msg字段