商户信息查询

功能概述

商户通过此接口查询二级商户基本信息以及结算信息。

接口地址

https://apis.5upay.com/serviceprovider/declaration/queryInfo

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 请求号 varchar(50) 二级商户入网接口传入的requestid C
subMerchantId 二级商户编号 varchar(9) 由首信易创建的二级商户编号(和请求号二选一传递)。 C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000593", "subMerchantId": "890000595", "hmac": null }

入网查询返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 请求号 同请求参数
subMerchantId 二级商户编号 由首信易创建的二级商户编号(和订单号二选一传递)
baseInfo 基本信息 见基本信息参数列表
bankCardInfo 结算信息 见结算信息参数列表
status 响应状态 SUCCESS 成功
ERROR 错误(此状态的返回参数见异常情况说明)
errorMessage 错误信息 错误信息
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

基本信息参数列表

参数名称 参数中文名称 参数说明
signedType 商户入网类型 BY_SPLIT_BILL 被分账方 GENERAL_SUB_MERCHANT 收单子商户
signedName 签约名称 签约名称
registerRole 商户签约性质 INDIVIDUAL_BUSINESS 个体工商户
PUBLIC_INSTITUTIONS 事业单位
PRIVATE_NON_ENTERPRISE_ORGANIZATIONS 民办非企业组织
SOCIAL_ORGANIZATION 社会团体
UNINCORPORATED_ENTERPRISE 非法人企业
ENTERPRISE_LEGAL_PERSON 企业法人
NATURAL_PERSON 自然人
GOVERNMENT_AGENCIES 政府机关
OTHERS 其他
createDateTime 创建时间 二级商户入网完成时间,例:2020-12-28 17:26:15
signedShorthand 商户简称 商户简称
businessAddressProvince 经营地址省 见编码表
businessAddressCity 经营地址市 见编码表
businessAddressArea 经营地址区 见编码表
businessAddress 经营地址 商户详细经营地址
contactName 联系人姓名 联系人姓名
contactEmail 联系人邮箱 联系人邮箱
contactPhone 联系人电话 联系人电话
businessClassification 业务分类 见编码表,此项分为一级和二级,传递此参数时需要用下划线拼接一级和二级业务分类,例如:一级为:INTERNAL_TESTING,二级为:01, 传递参数则是:INTERNAL_TESTING_01
cerType 证书类型 UNIFORM_SOCIAL_CREDIT_CODE 统一社会信用代码证
PRIVATE_NON_ENTERPRISE_UNIT_REGISTRATION_CERTIFICATE 民办非企业单位登记证书
INDIVIDUAL_BUSINESS_LICENCE 个体工商户营业执照
CERTIFICATE_OF_REGISTRATION_OF_SOCIAL_GROUP_LEGAL_PERSON 社会团体法人登记证书
LEGAL_PERSON_CERTIFICATE_OF_INSTITUTION 事业单位法人证书
FUND_LEGAL_PERSON_REGISTRATION_CERTIFICATE 基金法人登记证书
ID_CARD 身份证
BUSINESS_LICENSE 营业执照
OTHERS 其他
merchantStatus 商户状态 ACTIVATE 活动中
CLOSE 关闭
DELETED 删除
INIT 待激活
NOTACTIVATE 已冻结
REPAYING 清退
RETREAT 退驻
settmentStatus 出款状态 ACTIVE 可出款
UNACTIVE 不可出款

结算信息参数列表

参数名称 参数中文名称 参数说明
bankCode 开户行 见编码表
bankBranchName 支行名称 支行名称
accountName 开户名称 开户名称
bankCardNo 开户账号 开户账号
cityCode 市编码 见编码表
provinceCode 省编码 见编码表
accountType 结算银行卡属性 PUBLIC 对公
PRIVATE 对私

参数示例

{ "bankCardInfo": { "accountName": "测试1", "accountType": "PUBLIC", "bankBranchName": "支行", "bankCardNo": "999999999", "bankCode": "ZJRCU", "cityCode": "130100", "provinceCode": "130000" }, "baseInfo": { "businessAddress": "朝阳区", "businessAddressArea": "111111", "businessAddressCity": "111111", "businessAddressProvince": "111111", "businessClassification": "INTERNAL_TESTING_01", "cerType": "UNIFORM_SOCIAL_CREDIT_CODE", "contactEmail": "test1@123.com", "contactName": "联系人姓名1", "contactPhone": "13555555555", "createDateTime": "2020-12-28 17:26:15", "merchantStatus": "ACTIVATE", "registerRole": "ENTERPRISE_LEGAL_PERSON", "settmentStatus": "ACTIVE", "signedName": "测试1", "signedShorthand": "简称", "signedType": "GENERAL_SUB_MERCHANT" }, "hmac": "zTVkaQnyENwcXTUeM4ueeOzs8iw/8HuMA4IoBQtmgrx7FqMu/FWfTT rpadfY209wz+XGyRowoJ8LdMTZ3sT54NbzTGR1lx6ABcTQWWJCaixmtApw5 6qCgduYh7/n2jYZi0F9chrGIlUFv1328PiIIPLQxJr2oQPWY0GQe6vOd2vM Ozsszw+Ks4rTtsbmQ+q/uUyj34yQ5BJKYW7kN2zl8mzJzcAZ8m66w5xSlYA D11dGEQbyXRK177zJ4MZ6urEkgRzocta3avCGvt4T3tc39WXvrstb9oSV/ uTOnkRY7GrP4HgwN8BiGEmcOmI0TbBt6tTSm9wRtD8dplbDpuuKlQ==", "merchantId": "896666666", "requestId": "1609147569507", "status": "SUCCESS", "subMerchantId": "895511111" }