此接口用于修改已入网完成的二级商户信息。
https://apis.5upay.com/serviceprovider/declaration/modifyBaseInfo
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id，可在商户后台查看 | M |
| requestId | 订单号 | varchar(50) | 订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单，商户平台不能以相同的订单号再次提交。 | M |
| subMerchantId | 二级商户编号 | varchar(9) | 由首信易创建的二级商户编号(此项和signedRequestId二选一传递)。 | C |
| signedRequestId | 入网商户请求号 | varchar(50) | 此项传递二级商户入网时设定的requestId(此项和subMerchantId二选一传递) | C |
| signedShorthand | 商户简称 | varchar(80) | 商户简称 | O |
| businessAddressProvince | 经营地址省 | varchar(6) | 见编码表 | O |
| businessAddressCity | 经营地址市 | varchar(6) | 见编码表 | O |
| businessAddressArea | 经营地址区 | varchar(6) | 见编码表，如果选择的省市只有两级没有下一级时可不传此字段，如：东莞市、中山市、三沙市、儋州市，除此四个市之外的其他市均需要传此字段 | O |
| businessAddress | 经营地址 | varchar(200) | 商户详细经营地址 | O |
| contactName | 联系人姓名 | varchar(50) | 联系人姓名 | O |
| contactEmail | 联系人邮箱 | varchar(100) | 联系人邮箱 | O |
| contactPhone | 联系人电话 | varchar(11) | 联系人电话 | O |
| modifyType | 修改类型 | 固定值 | INFO 基本信息修改 | C |
| CERTIFICATE 核查补充 | ||||
| 不传默认为基本信息修改 | ||||
| businessLicensePath | 营业执照照片路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需将上传到sftp,连接方式见SFTP数据传输说明(商户类型不为自然人时必传,最大不超过1M,格式限制为jpg,png,bmp) | O |
| openAccountPath | 开户许可证照片路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(商户类型不为自然人及个体工商户时必传,为个体工商户时此项和legalPersonBankCardPath二选一进行传递,最大不超过1M,格式限制为jpg,png,bmp) | O |
| legalIdCardProsPath | 法人证件人像面路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(最大不超过 1M，格式限制为jpg,png,bmp) | O |
| legalIdCardConsPath | 法人证件国徽面路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(最大不超过1M,格式限制为jpg,png,bmp) | O |
| desireAuthPath | 确认入网意愿视频路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp，连接方式见SFTP数据传输说明(认证类型选择视频认证时必填,最大不超过5M,格式限制为 avi、wmv、 mpeg、mp4、mov、mkv、flv、f4v、m4v、rmvb) | O |
| holdingIdCardPath | 法人手持证件影印件路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp，连接方式见SFTP数据传输说明(认证类型选择手机验证时必传,最大不超过1M,格式限制为jpg,png,bmp) | O |
| webSitePath | 商户网址截图影印件路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(商户类型不为自然人或被分账方 时,如交易场景基于PC网站时必传, 最大不超过1M，jpg,png,bmp) | O |
| wechatAppletPath | 公众号/小程序/生活号业务流程截图影印件路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(商户类型不为自然人或被分账方 时,如交易场景基于 PC 网站时必传, 最大不超过 1M，jpg,png,bmp) | O |
| appPath | APP 首页截图影印件路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(商户类型不为自然人或被分账方 时,如交易场景基于APP时必传,最 大不超过1M,格式限制为 jpg,png,bmp) | O |
| legalPersonBankCardPath | 法人银行卡图影印件路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(商户类型为自然人时必传,为个体 工商户时,结算银行卡属性为对私, 此项必填。结算银行卡属性为对公, 此项和 openAccountPath 二选一进行 传递,最大不超过1M.格式限制为 jpg,png,bmp)请提交盖章件 | O |
| desireAuthOtherPath | 确认入网意愿其他验证方式路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(开户意愿核实类型选择“其他验证 方式”的时候必传，最大不超过2M， 格式限制为jpg,png,bmp) | O |
| otherCerPath | 其他资质文件路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(最大不超过5M,格式限制为 AVI、 mov、rmvb、rm、FLV、mp4、3GP、jpg、 jpeg、png、pdf、ZIP、RAR) | O |
| storeHeaderPath | 门店门头照片路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(若“店内场景照片路径”字段传值， 则该字段必传，最大不超过 2M，格式 限制为 jpg,png,bmp) | O |
| storeIndoorPath | 店内场景照片路径 | varchar(200) | 当修改类型为“核查补充”时可填写,需上传到sftp,连接方式见SFTP数据传输说明(若“门店门头照片路径”字段传值,则该字段必传,最大不超过2M,格式限制为jpg,png,bmp) | O |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| subMerchantId | 二级商户编号 | 由首信易返回的二级商户编号，如传入此参数则会返回 |
| requestId | 订单号 | 同请求参数 |
| signedRequestId | 入网商户请求号 | 二级商户入网时设定的requestId，如传入此参数则会返回 |
| status | 响应状态 | SUCCESS 成功 |
| FAILED 失败 | ||
| ERROR 错误(此状态的返回参数见异常情况说明) | ||
| errorMessage | 错误信息 | 错误信息 |
| hmac | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |