提供影像资料批量上传功能，可将图片用base64字符格式批量传送给慧收钱平台，平台同步返回受理成功，平台处理完毕将资质文件批量上传结果通过接口上送的通知地址通知给商户或通过资质文件批量上传结果查询接口查询结果。本接口只支持验签算法RSA2。

接口说明

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

文件上传生产请求URL：https://api.huishouqian.com/merchant/register

请求方式：POST

公共请求参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] 是 BATCH_FILE_UPLOAD-影像资料批量上传
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] 否 签名数据

业务请求参数

量变 参数名 类型[长度限制] 必填 描述
requestDate 请求时间 string[14] M
returnUrl 通知地址 string[64] O 上送后则通过该地址主动通知文件上传结果 https://xxx.com/notify
qualification 资质文件 object M JSON格式
参数名 参数描述 类型[长度限制] 必填 备注
idCardFrontImg 法人身份证正面 string M Base64 加密字符串
idCardBackImg 法人身份证反面 string M Base64 加密字符串
idCardHandImg 法人手持身份证照 string C Base64 加密字符串
storeImg 门头照 string C Base64 加密字符串
businessLicenseImg 营业执照 string C Base64 加密字符串
bankLicenseImg 开户许可证 string O Base64 加密字符串
protocolImg 平台协议 string C Base64 加密字符串
socialCreditCodeImgUrl 统一社会信用代码 string O Base64 加密字符串
icNetScreenShotUrl 工商网截图 string O Base64 加密字符串
icpImg icp备案照片 string O Base64 加密字符串
orgCodeImg 组织机构代码证照片 string O Base64 加密字符串
placeImg 营业场所照片 string O Base64 加密字符串
otherImgs 其它图片 string O Base64 加密字符串
bankImg 银行卡 string O Base64 加密字符串

公共请求示例

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

业务请求示例

公共响应参数

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

业务响应参数

变量 参数名 类型[长度限制] 必填 描述
batchNo 批次号 string[1,32] 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
}

业务响应示例

交易状态码

交易状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
FINISHED 完成
作者：xiaochen  创建时间：2023-05-24 15:12
最后编辑：xiaochen  更新时间：2024-10-21 15:46