门店进件前需要调用资质文件上传接口上传相关资质文件。
商户需要将门店信息通过API方式上送到慧收钱，慧收钱生产门店并返回。

接口说明

测试请求URL：https://test-api.huishouqian.com/merchant/register

生产请求URL：https://api.huishouqian.com/merchant/register

请求方式：POST

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] 是 SIMPLE_STORE_REPORT
version 版本 string[1,16] 是 接口版本：2.0.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON、XML
agentMerchantNo 代理商商户号 string[1,16] 是 商户在慧收钱的代理商商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 RSA2:签名机制查看说明
signContent 加密数据 string 是 业务请求参数
sign 签名数据 string[1,128] 否 签名数据

业务请求参数

变量 参数名 类型[长度限制] 必填 描述
基本信息
transNo 进件请求流水号 string[1,32] M 商户请求进件唯一流水号，每次请求不可重复；
merchantName 门店全称 string[1,32] M 营业执照上的商户名称
merchantShortName 门店简称 string[1,16] M 在支付完成页展示给消费者
industryType 经营类目 string[1,16] M 详见附录经营类目
merchantIdType 企业/个体证件类型 string[1,32] O 默认NATIONAL_LEGAL
NATIONAL_LEGAL：营业执照；
NATIONAL_LEGAL_MERGE：营业执照(多证合一)；
INST_RGST_CTF：事业单位法人证书
businessLicense 企业/个体证件编号 string[1,32] M 企业/个体证件编号
storeType 门店类型 string[1,16] M PERSON：个人
ORG：企业；
INDIVIDUAL：个体工商户
merchantNo 商户编号 string[1,16] M 慧收钱生成商户编号，填写后报备信息关联此商户
地址信息
districtCode 地区编码 string[1,16] M 门店所在地区编码。详见附录省市编码
address 地址 string[1,128] M 门店所在地址
法人信息
legalName 法人姓名 string[1,16] M 法定代表人姓名
legalIdcardNo 法人证件号码 string[1,32] M 证件号码
legalIdcardType 法人证件类型 string[1,16] O 默认身份证。详见附录证件类型
联系人信息
contactName 联系人姓名 string[1,16] O 联系人姓名
contactPhone 联系人手机号 string[1,16] O 联系人手机号码
contactIdcardType 联系人证件类型 string[1,16] O 默认身份证。详见附录证件类型
contactIdcardNo 联系人证件号 string[1,32] O 联系人证件号码
contactEmail 联系邮箱 string[1,32] O 联系人邮箱
影像资料
storeImg 门头照 string[1,32] M 对应资质文件上传接口返回的fileId
placeImg 营业场所照片 string[1,32] M 对应资质文件上传接口返回的fileId
businessLicenseImg 企业/个体证件类型照 string[1,32] O 对应资质文件上传接口返回的fileId
otherImgs 其它图片 string[1,32] O 最多支持六张，多个逗号（,）隔开。对应资质文件上传接口返回的fileId
预留信息
extend1 扩展字段 string[1,128] O

公共请求示例

{method=AGENT_REGISTER_PERSON, format=json, signType=CFCA, signContent=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}

业务请求示例

{
    "address":"浦东新区郭守进路",
    "businessLicense":"24242422424",
    "contactIdcardNo":"110101199003078937",
    "contactName":"张三",
    "storeType":"PERSON",
    "contactPhone":"13886574732",
    "districtCode":"310115",
    "contactEmail":"20220406162824@qq.com",
    "idCardBackImg":"8e188929-4961-42d9-b304-c53f0067d5c1",
    "idCardFrontImg":"8e188929-4961-42d9-b304-c53f0067d5c1",
    "industryType":"5311",
    "contactLogonId":"5311",
    "contactWeChatId":"F0001",
    "legalIdcardNo":"110101199003078937",
    "legalName":"姜晓丽",
    "legalPhone":"13886574732",
    "merchantNo":"834509524472",
    "merchantName":"测试商户20211129180215",
    "merchantShortName":"测试商户20211129180215",
    "otherImgs":"8e188929-4961-42d9-b304-c53f0067d5c1",
    "placeImg":"8e188929-4961-42d9-b304-c53f0067d5c1",
    "transNo":"20220406162824",
    "servicePhone":"13886574732",
    "storeImg":"8e188929-4961-42d9-b304-c53f0067d5c1"
}

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 是 服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 否 响应码
errorMsg 错误描述 string[1,128] 否 响应描述
result 响应内容 string 否 业务响应参数
sign 签名数据 string[1,128] 否 响应验签数据

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
transNo 进件请求流水号 string[1,32] R 商户请求进件唯一流水号，每次请求不可重复
applyNo 进件申请编号 string[1,16] M 慧收钱生成进件申请编号
status 状态 string[1,16] M 状态码
respCode 应答码 string[1,16] C 交易响应码
respMsg 应答信息 string[1,128] C 应答信息描述

公共响应示例

{
"success":true,
"result":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d",
"errorCode":null,
"errorMsg":null,
"sign":null
}

业务响应示例

申请状态码

状态码 描述
AUDIT 审核中
REVIEW 复审中
AUDIT_PASS 审核通过
AUDIT_REFUSE 审核拒绝
CLOSE 销户
STAY 协议待生成
WAIT 待签约
FAILURE 签约失败
SIGNED 已签约

交易状态码

交易状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
FINISHED 完成

交易响应码

响应码 描述
110000 受理成功
110001 系统异常，请稍后再试
110002 代理商不存在
110003 外部商户号重复
110004 接口权限不足
110005 参数错误，校验不通过
110006 商户号信息不存在
110007 暂未开通任何支付功能
110008 文件类型不合法
110009 文件大小超限
110010 开户许可图片不存在
110011 营业执照图片不存在
110012 身份证正面图片不存在
110013 身份证反面图片不存在
110014 门头照图片不存在
110015 手持身份证正面图片不存在
110016 工商网截图图片不存在
110017 IPC备案图图片不存在
110018 组织机构代码图片不存在
110019 统一信用代码图片不存在
110020 营业场所图片不存在
110021 其它图片不存在
110022 暂不支持此支付功能在线开通
110023 商户审核中,暂不支持开通支付功能
110024 支付功能已开通,请勿重复开通

证件类型

证件类型 描述
1 大陆身份证
2 护照
3 港澳居民来往内地通行证
4 台湾居民来往内地通行证
5 其它
作者：xiaochen  创建时间：2023-05-24 15:13
最后编辑：xiaochen  更新时间：2024-10-21 15:46