此接口用于修改已入网完成的子商户基本信息。
https://apis.5upay.com/serviceprovider/declaration/merchantInfoChange
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
partnerId | 服务商id | varchar(9) | 子商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 | C |
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
requestId | 请求号 | varchar(50) | 请求号为商户自行拟定,提交的请求号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的请求号再次提交。 | M |
notifyUrl | 通知地址 | varchar(200) | 服务器通知:当入网状态为终态后首信易服务器会向该地址发送通知,该地址可以带参数,如:http://www.5upay.com/callback.action?test=test。 | M |
merchantSubjectInfo | 商户主体信息 | Json | 见商户主体信息表 | C |
businessInfo | 经营信息 | Json | 见经营信息表 | C |
legalPersonInfo | 法人信息 | Json | 见法人信息表 | C |
contactInfo | 商户联系人信息 | Json | 见商户联系人信息表 | C |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
本接口资质信息上传需要配合ftp使用
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
signedShorthand | 商户简称 | 固定值 | 商户简称 | C |
businessLicensePath | 营业执照照片路径 | varchar(200) | 需上传到sftp,见开发者服务-sftp数据传输说明(最大不超过1M,格式限制为jpg,png,bmp) | C |
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
businessClassification | 业务分类 | 固定值 | 见编码表,此项分为一级和二级,传递此参数时需要用下划线拼接一级和二级业务分类,例如:一级为:LIFE_SERVICE,二级为:08,
传递参数则是:LIFE_SERVICE_08 (商户入网类型为收单子商户时必传,被分账方默认取父商户) |
C |
businessAddressProvince | 经营地址省 | varchar(6) | 见编码表,当商户签约性质为自然人时,传入自然人身份证住址信息。当businessAddress不为空时,此值必填 | C |
businessAddressCity | 经营地址市 | varchar(6) | 见编码表,当商户签约性质为自然人时,传入自然人身份证住址信息,当businessAddress不为空时,此值必填 | C |
businessAddressArea | 经营地址区 | varchar(6) | 见编码表,当商户签约性质为自然人时,传入自然人身份证住址信息。如果选择的省市只有两级没有下一级时可不传此字段。当businessAddress不为空且有实际所属区时,此值必传 | C |
businessAddress | 经营地址 | varchar(200) | 商户详细经营地址,当商户签约性质为自然人时,传入自然人身份证住址信息。当修改经营地址省市区时,此值必传 | C |
storeHeaderPath | 门店门头照片路径 | varchar(200) | 门店门头照片路径 | C |
storeIndoorPath | 店内场景照片路径 | varchar(200) | 店内场景照片路径 | C |
注:门店门头照、店内场景照片要求招牌清晰可见 流动经营/便民服务:提交经营/服务现场照片线上商品/服务交易:提交店铺首页截图。(最大不超过2M,格式限制为jpg,png,bmp)
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
legalPersonIdType | 法人证件类型 | 固定值 | IDCARD 身份证 | C |
legalPersonName | 法人姓名 | varchar(50) | 法人姓名 | C |
legalPersonIdNo | 法人身份证号 | varchar(20) | 法人身份证号 | C |
legalIdCardProsPath | 法人证件人像面路径 | varchar(200) | 需上传到sftp,见开发者服务-sftp数据传输说明(最大不超过1M,格式限制为jpg,png,bmp) | M |
legalIdCardConsPath | 法人证件国徽面路径 | varchar(200) | 需上传到sftp,见开发者服务-sftp数据传输说明(最大不超过1M,格式限制为jpg,png,bmp) | M |
idEffectiveDateStart | 法人证件有效期开始日期 | varchar(10) | 格式:yyyy-MM-dd,例:2020-08-03 | M |
idEffectiveDateEnd | 法人证件有效期结束日期 | varchar(10) | 格式:yyyy-MM-dd,例:2030-08-03。若为长期可传 2099-12-31 | M |
注:法人证件人像面、法人证件国徽面照片,最大不超过1M,格式限制为jpg,png,bmp
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
contactName | 联系人姓名 | varchar(50) | 联系人姓名 | C |
contactEmail | 联系人邮箱 | varchar(100) | 联系人邮箱 | C |
contactPhone | 联系人电话 | varchar(11) | 联系人电话 | C |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
partnerId | 服务商id | 同请求参数 |
requestId | 订单号 | 同请求参数 |
status | 响应状态 | SUCCESS 成功 FAILED 失败 ERROR 错误(此状态的返回参数见异常情况说明) |
errorMessage | 错误信息 | 错误信息 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
partnerId | 服务商id | 同请求参数 |
requestId | 订单号 | 同请求参数 |
reviewStatus | 审核状态 | INIT待审核 PROCESSING审核中(人工审核时返回该状态) PASS审核通过 REFUSE审核拒绝 |
remark | 审核备注 | 审核备注 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |