商户信息变更接口

功能概述

此接口用于修改已入网完成的子商户基本信息。

接口地址

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使用

请求参数(merchantSubjectInfo,商户主体信息)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
signedShorthand 商户简称 固定值 商户简称 C
businessLicensePath 营业执照照片路径 varchar(200) 需上传到sftp,见开发者服务-sftp数据传输说明(最大不超过1M,格式限制为jpg,png,bmp) C

请求参数(businessInfo,经营信息)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
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)

请求参数(legalPersonInfo,法人信息)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
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

请求参数(contactInfo,商户联系人信息)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
contactName 联系人姓名 varchar(50) 联系人姓名 C
contactEmail 联系人邮箱 varchar(100) 联系人邮箱 C
contactPhone 联系人电话 varchar(11) 联系人电话 C

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "merchantId":"895186985", "partnerId":"890000593", "requestId":"IDD-1684075315475", "notifyUrl":"https://sdk.5upay.com/onlinepay/notify_V3", "merchantSubjectInfo":{ "businessLicensePath":"", "signedShorthand":"测试商户" }, "hmac":"OBeNcj/9TT5BUXMGSZHXyBYqN2fEcixaGr6SbkxPY7Po0UcIBxr6YKKPd4IEyrnFbevXCToSnNWd1JfgjBlpxB3eY +ejhpt3DEcwoZLfrvb5j7C6+aRKgMEuePfefZg==" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商id 同请求参数
requestId 订单号 同请求参数
status 响应状态 SUCCESS 成功
FAILED 失败
ERROR 错误(此状态的返回参数见异常情况说明)
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "partnerId":"890000593", "merchantId":"895186985", "requestId":"IDD-1684075315475", "hmac":"HNYHNGgPGz6N2fZh6Nzili/BQVME1LW6jM1d5G9P6Bz88Jo476q0G/rLVC2MA7FXJQXUrctaFCQs8iZdeTTU9wCJNNCz OVpb7H8swpJopvounQh5HNg5a36OWalQ==", "status":"SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商id 同请求参数
requestId 订单号 同请求参数
reviewStatus 审核状态 INIT待审核
PROCESSING审核中(人工审核时返回该状态)
PASS审核通过
REFUSE审核拒绝
remark 审核备注 审核备注
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId":"895186985", "requestId":"IDD-1684075315475", "hmac":"UtZLCHSyIyQ2XpeVg7hJv+oou48hKQGw8bt2FoJx7aWckNKRauVx2hlAQLzbtBOqEUbVW4JIMJ2Yi4obsga0DfdsZ2h dhpk7FJRPZz0JWgATtyPtWVByTPh3cuJw==", "remark":"审核通过", "reviewStatus":"PASS", "partnerId":"890000593" }