此接口用于修改已入网完成的二级商户基本信息。
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 |
| desireAuthInfo | 法人信息 | Json | 见法人信息表 | C |
| contactInfo | 商户联系人信息 | Json | 见商户联系人信息表 | C |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
本接口资质信息上传需要配合ftp使用
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| signedShorthand | 商户简称 | 固定值 | 商户简称 | C |
| businessLicensePath | 营业执照照片路径 | varchar(200) | 需上传到sftp,见开发者服务-sftp数据传输说明（最大不超过1M，格式限制为jpg,png,bmp） | C |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| businessClassification | 业务分类 | 固定值 | 见编码表.xlsx，此项分为一级和二级，传递此参数时需要用下划线拼接一级和二级业务分类， 例如：一级为：INTERNAL_TESTING，二级为：01， 传递参数则是：INTERNAL_TESTING_01 (商户入网类型=收单子商户时必传，被分账方默认取父商户) |
C |
| businessAddressProvince | 经营地址省 | varchar(6) | 见编码表，当商户签约性质为自然人时，传入自然人身份证住址信息 | C |
| businessAddressCity | 经营地址市 | varchar(6) | 见编码表，当商户签约性质为自然人时，传入自然人身份证住址信息 | C |
| businessAddressArea | 经营地址区 | varchar(6) | 见编码表，当商户签约性质为自然人时，传入自然人身份证住址信息。如果选择的省市只有两级没有下一级时可不传此字段，如：东莞市、中山市、三沙市、儋州市，除此四个市之外的其他市均需要传此字段 | 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 | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |