核查补充

功能概述

此接口用于先入后审流程中提交核查补充的入网资料。

接口地址

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
modifyType 修改类型 固定值 CERTIFICATE 核查补充 M
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":"890000593", "requestId":"1689039900178", "subMerchantId":"893932320", "modifyType":"CERTIFICATE", "legalIdCardConsPath":"/serviceprovider/id/image1.jpg", "legalIdCardProsPath":"/serviceprovider/id/image2.jpg", "hmac": null }

返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
subMerchantId 子商户编号 由首信易返回的子商户编号,如传入此参数则会返回
requestId 订单号 同请求参数
signedRequestId 入网商户请求号 子商户入网时设定的requestId,如传入此参数则会返回
status 响应状态 SUCCESS 成功
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "890000593", "subMerchantId": "893932320", "requestId": "1689039900178", "hmac": "959e138ad2e290328e8d59fd124c618f", "status": "SUCCESS" }