接口地址
生产环境:https://cus.allinpay.com/cusapi/merchantapi/edit
测试环境:https://syb-test.allinpay.com/vsppcusapi/merchantapi/edit
使用场景:
商户调用接口提交修改商户号状态为“正常”的商户信息:
修改商户基本信息
补充商户附件图片
请求参数:
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
orgid |
代理商号 |
平台分配的代理商号 |
否 |
15 |
|
cusid |
商户号 |
审核通过的商户号 |
否 |
15 |
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
shortname |
商户简称 |
|
可 |
40 |
20个文字内 |
servicephone |
客服电话 |
|
可 |
32 |
业务联系人电话 |
corpbusname |
营业执照名称 |
|
可 |
64 |
商户性质非个人时需要填写 |
creditcode |
统一社会 信用代码证 |
|
可 |
32 |
商户性质非个人时需要填写 |
creditcodeexpire |
社会信用 代码证有效期 |
|
可 |
10 |
商户性质非个人时需要填写 |
legal |
法人姓名 |
|
可 |
32 |
|
legalidtype |
法人代表 证件类型 |
01、04、05 |
可 |
2 |
01身份证 04港澳通行证 05台湾通行证 |
legalidno |
法人代表 证件号 |
|
可 |
50 |
|
legalidexpire |
法人身份证 有效期 |
|
可 |
10 |
|
address |
注册地址 |
|
可 |
200 |
|
contactperson |
商户负责人 |
|
可 |
32 |
财务联系人(收短信用) |
contactphone |
商户负责人 电话 |
|
可 |
32 |
财务联系人电话 |
signtype |
签名类型 |
|
|
|
RSA/SM2 |
sign |
签名 |
详见安全规范 |
否 |
32 |
|
addfacusid |
所属父客户 |
|
可 |
15 |
|
notifyurl |
回调url |
|
否 |
|
回调结果格式请参照2.4 进件通知 |
zipurl |
附件url |
|
可 |
|
只支持zip压缩包 |
picstrurl |
附件url拼接 |
https://mvsp.com/001.png; |
可 |
1000 |
图片url以;作为分隔 pic1url;pic2url (支持不大于5张的图片url的拼接)
|
holdername |
控股股东姓名 |
|
可 |
64 |
商户性质为企业、个体户时必填 |
holderidno |
控股股东身份证 |
|
可 |
10 |
商户性质为企业、个体户时必填 |
holderexpire |
控股股东有效期 |
|
可 |
10 |
商户性质为企业、个体户时必填 |
registerfund |
注册资本 |
1: 注册资本<10万元 2: 10万元<注册资本<20万元 3: 20万元<注册资本<50万元 4: 50万元<注册资本<100万元 5: 注册资本>100万元 |
可 |
1 |
商户性质为企业、个体户时必填 |
stafftotal |
员工人数 |
1: 员工数量<10 2: 10<员工数量<20 3: 20<员工数量<50 4: 50<员工数量<100 5: 员工数量>100 |
可 |
1 |
商户性质为企业、个体户时必填 |
operatelimit |
经营区域 |
1:城区 2: 郊区 3:边远地区 |
可 |
1 |
商户性质为企业、个体户时必填 |
inspect |
经营地段 |
1:商业区 2:工业区 3:住宅区 |
可 |
1 |
商户性质为企业、个体户时必填 |
thrcertflag |
是否三证合一 |
1:是 0:否 |
可 |
1 |
|
organcode |
组织机构 代码证号 |
|
可 |
64 |
三证合一否时需要填写
|
organexpire |
组织机构 代码证有效期 |
|
可 |
10 |
三证合一否时需要填写
|
busconactperson |
业务联系人 姓名 |
|
可 |
32 |
非个人类商户必填 |
busconacttel |
业务联系人 电话 |
|
可 |
11 |
非个人类商户必填 |
unsdremark |
渠道备注 |
|
可 |
100 |
渠道备注信息 |
legaldetail |
法人信息json |
|
可 |
1000 |
json内详情见进件说明 |
busdetail |
经营内容 |
|
可 |
100 |
|
taxdetail |
税务登记 详情json |
|
可 |
500 |
|
bnfdetail |
受益人信息json |
|
可 |
512 |
|
cusurl |
网站url或 下载地址或 平台名称 |
|
可 |
100 |
|
webname |
网站名称 /应用名称 |
|
可 |
50 |
|
businessplace |
经营场所 |
1/2/3/4 为空时默认填1 |
可 |
1 |
1独立门店、连锁店、专卖店 2综合卖场 3批发市场 4其它 |
merchantname |
商户名称 |
|
可 |
100 |
|
busaddress |
商户经营地址 |
|
可 |
60 |
|
districtcode |
所在区 |
|
可 |
10 |
|
tlbankno |
电子账户号 |
|
可 |
30 |
|
creditCodeType |
营业执照 类型 |
|
可 |
100 |
营业执照类型 |
creditCodeStartdate |
营业证件 成立日期 |
|
可 |
10 |
营业证件成立日期 yyyy-MM-dd |
legalidStartdate |
法人证件 生效日期 |
|
可 |
10 |
法人证件生效日期 yyyy-MM-dd |
响应参数:
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
---|---|---|---|---|---|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS-请求成功 FAIL-请求或前端处理失败,具体看retmsg |
retmsg |
返回码说明 |
|
是 |
100 |
|
trxstatus |
交易状态码 |
1000|1999 |
否 |
4 |
1000: 获取结果成功 1999:获取结果失败 |
orgid |
代理商号 |
|
否 |
15 |
与请求一致 |
cusid |
商户号 |
|
否 |
15 |
与请求一致 |
以下信息只有当retcode为SUCCESS时有返回 |
|||||
auditstatus |
审核状态 |
00|01|02|03|04 |
否 |
15 |
00-受理成功待提交审核 |
errmsg |
错误信息 |
|
是 |
100 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |