2.5商户基本信息管理接口


接口地址
生产环境: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;
https://mvsp..com/newattachment/1.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-受理成功待提交审核
01-审核中
02-审核通过
03-审核失败
04-提交审核失败

errmsg

错误信息

 

100

 

sign

签名

 

32

详见安全规范

 
 
 
 

 

yinjr 2025年3月20日 22:20 收藏文档