工商信息服务

数据 收单机构 商户 发卡机构 快速接入
工商信息检索、验证、关注

接入服务商：银联技术开放平台

API ID：333

接口状态：正常

业务申请
暂不支持测试

接口名称

获取产品调用token信息

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据，用户调用各接口时都需使用产品token。

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
过期时间 expire_in long M-必填 凭证有效时间，单位：秒
产品token token string M-必填 获取到的凭证; 凭证是字符串

接口名称

更新关注工商信息

接口描述

对机构自己关注的企业或个体户列表进行增加或删除操作

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/updFollowingEntMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
请求参数组 reqParas string 3000 M-必填 请求参数填写法人营业执照号，请求参数组最多支持50个参数，其中每个参数使用“|”分隔。例如：插入关注信息 请求类型为： 001 请求参数为： 123456789012345670|123456789012345671|123456789012345672|123456789012345673
关注请求类型 followingReqTp string 3 M-必填 001-插入关注信息 002-取消关注信息
请求保留域 reqtResFld string 20 O-选填 保留

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填

接口名称

验证工商信息

接口描述

验证企业或个体户信息是否存在、是否准确、是否匹配

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/vfyEntMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
法定代表人 legalRepName string 200 O-选填
企业注册地址 dom string 512 O-选填
企业(机构)名称 entName string 100 O-选填
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填
响应信息 msg array M-必填
验证结果 vfyIn string 1 O-选填 0-验证通过 1-验证未通过

接口名称

工商信息检索

接口描述

通过营业执照号检索企业或个体户基本信息

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/entInfoQrMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map 0 M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填 无
响应信息 msg map 0 M-必填
统一社会信用代码 uniscid string 18 M-必填
企业（机构）名称 entname string 100 M-必填
注册号 regno string 50 M-必填
市场主体类型（中文） enttypeCn string 128 M-必填
成立日期 estdate. string 8 M-必填 YYYYMMDD
登记机关（中文） regorgCn string 128 M-必填
业务范围类型（中文） opScoTypeCn string 128 M-必填
经营范围 opscope string 3000 M-必填
经营(驻在)期限自 opfrom string 8 M-必填 YYYYMMDD
经营(驻在)期限至 opto string 8 M-必填 YYYYMMDD
登记状态（中文） regstateCn string 128 M-必填
企业注册地址 dom string 512 M-必填
注册资本(金) regcap string 18 M-必填 单位：万元 外国企业-资金数额，合伙-出资额，个独-出资额，农专-成员出资总额
注册资本(金)币种（中文） regcapcurCn string 128 M-必填
法定代表人 legalRepName string 200 M-必填
核准日期 apprdate string 8 M-必填 YYYYMMDD
吊销日期 revdate string 8 M-必填 YYYYMMDD
注销日期 candate string 8 M-必填 YYYYMMDD

接口名称

关注信息检索

接口描述

机构自己获取自己关注的企业或个体户列表

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/followedEntInfoQrMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填 无
响应信息 msg map M-必填
关注状态 followingIn string 1 M-必填 0-已关注 1-未关注

接口名称

股东信息列表检索

接口描述

对通过营业执照号码检索指定企业的股东信息请求的应答

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/entShareholderListQrMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
页码 queryPage string 4 M-必填
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填 无
响应信息 msg map M-必填
股东列表检索结果 shareholderList array O-选填
股东姓名 shareholderList.shareholderName string 200 M-必填
认缴出资额 shareholderList.subconam string 18 M-必填
国别(地区) shareholderList.countryCn string 128 M-必填
出资方式（个独） shareholderList.sconform string 200 M-必填 1-以个人财产出资,2-以家庭共有财产作为个人出资
股东认缴信息 shareholderList.paidInInfoList array O-选填
股东认缴出资额 shareholderList.paidInInfoList.SHSubconam string 18 M-必填
认缴出资方式 shareholderList.paidInInfoList.conformCn string 128 M-必填
认缴出资日期 shareholderList.paidInInfoList.condate string 8 M-必填 YYYYMMDD
页码 queryPage string 4 M-必填
总页数 recordPgCount string 4 M-必填
当前页记录数 currentPgCount string 5 M-必填
总记录数 recordCount string 5 M-必填

接口名称

主要成员列表检索

接口描述

通过营业执照号码检索企业的高管信息

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/entPersionnelListQrMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
页码 queryPage string 4 M-必填
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填 无
响应信息 msg map M-必填
主要成员列表检索结果 personList array O-选填
成员姓名 memberName string 200 M-必填
职务 positionCn string 128 M-必填
页码 queryPage string 4 M-必填
总页数 recordPgCount string 4 M-必填
当前页记录数 currentPgCount string 5 M-必填
总记录数 recordCount string 5 M-必填

接口名称

变更信息列表

接口描述

通过营业执照号码检索该企业所做过的变更

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/altInfoListQrMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
页码 queryPage string 4 M-必填
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填 无
响应信息 msg map M-必填
变更信息列表检索结果 altInfoList array O-选填
变更事项 altitemCn string 128 M-必填
变更前内容 altbefore string 4000 M-必填
变更后内容 altafter string 4000 M-必填
变更日期 altdate string 8 M-必填 YYYYMMDD
页码 queryPage string 4 M-必填
总页数 recordPgCount string 4 M-必填
当前页记录数 currentPgCount string 5 M-必填
总记录数 recordCount string 5 M-必填

接口名称

发生变更的工商企业列表

接口描述

机构检索出指定日期范围内发生变更的企业列表

接口地址

测试地址： 暂无

生产地址： https://openapi.unionpay.com/upapi/entinfo/altEntListQrMsg

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位：毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 11 C-依条件必填 机构接入时，此参数必填，且必须为接入账号的真实机构代码
商户号 mchId string 15 C-依条件必填 商户接入时，此参数必填，且必须为接入账号的真实商户号
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
法人营业执照号 busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
查询结果起始日期 qryRsltBgnDt string 8 M-必填 查询结果起始日期和查询结果结束日期最长跨度为一周。格式为YYYYMMDD
查询结果结束日期 qryRsltEndDt string 8 M-必填 查询结果起始日期和查询结果结束日期最长跨度为一周。格式为YYYYMMDD
页码 queryPage string 4 M-必填
请求保留域 reqtResFld string 20 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 200 M-必填
响应数据 data map M-必填
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号，当前支持的版本号为A1
应答保留域 reserveFld string 20 O-选填 无
响应信息 msg map M-必填
发生变更的企业列表 altEntList array O-选填
法人营业执照号 altEntList.busLicense string 50 M-必填 指的是统一社会信用代码或者注册号。一般来说统一社会信用代码是18位定长字符串，注册码是15位定长字符串，但存在少量不规范的营业执照号小于15位的情况。
页码 queryPage string 4 M-必填
总页数 recordPgCount string 4 M-必填
当前页记录数 currentPgCount string 5 M-必填
总记录数 recordCount string 5 M-必填
产品详情

对外承诺服务时间5*8小时（9:00~17:00）

应用对象

商户和机构用户，开发者用户不可用

接入流程

1、目前该产品API仅面向特定的接入方提供服务，如有相关需求，请联系业务接口人说明相关使用需求；

2、业务接口人评估后向接入方提供相关材料，接入方确认相关材料进行线下签约，完成签订。

3、如需调用该API，请点击右上角“业务申请”，并认真填写相关内容，待业务接口人审核通过后即可（审核周期为2-3个工作日）；

4、技术联调，可参照《“快速接入”产品API技术文档—接入指南》。


应答码参照：
应答码 描述
0000 调用成功
0001 调用成功，但包含错误信息
0002 业务异常
9917 您的账号不具备当前产品API请求权限，请联系相关业务接口人。
9999 系统出现错误

1.获取产品调用token信息

应答JSON报文体：

{

    “token”： “”，

    “expire_in”: 7200

}

2.更新关注工商信息

请求JSON报文体：

{

    “insIdCd”: “00010001”,

    “followingReqTp ”: “001”,

    ……

}

应答JSON报文体：

{    
    
    “respCd”： “0000”，
    
    “respMsg”: “”,
    
    “data”: [
    
        {
        
            “msgVersionCd”: “”
        
        }
    
    ]
    
}

3.验证工商信息

请求JSON报文体：

{

    “insIdCd”: “00010001”,

    “busLicense”: “”

}

应答JSON报文体：

{

    “respCd”： “0000”，

    “respMsg”: “”,

    “data”: {

        “msgVersionCd”: “”

    }

}

4.工商信息检索

请求JSON报文体：

{

    “insIdCd”: “00010001”,

    “busLicense”: “”

}

应答JSON报文体：

{

    “respCd”： “0000”，

    “respMsg”: “”,

    “data”: {

        “msg”: {



        }

    }

}

5.关注信息检索

请求JSON报文体：

{

    “insIdCd”: “00010001”,
    
    “busLicense”: “”
    
}

应答JSON报文体：

{

    “respCd”： “0000”，

    “respMsg”: “”,

    “data”: {

    “msgVersionCd”: “”

    }

}

6.股东信息列表检索

请求JSON报文体：

{

    “insIdCd”: “00010001”,
    
    “busLicense”: “”
}

应答JSON报文体：

{

    “respCd”： “0000”，

    “respMsg”: “”,

    “data”: {

        “msg”: {

            “shareholderList”: [

                {

                    “shareholderName”: “”,

                    “subconam”: “”

                }

            ]

    }

}

}

7.主要成员列表检索

请求JSON报文体：

{

    “insIdCd”: “00010001”,
    
    “busLicense”: “”
    
}

应答JSON报文体：

{
    “respCd”： “0000”，
    
    “respMsg”:“”,
    
    “data”: {
    
        “msgVersionCd”:
        
     }
     
}

8.变更信息列表

请求JSON报文体：

{

    “insIdCd”: “00010001”,
    
    “busLicense”: “”
    
}

应答JSON报文体：

{

    “respCd”： “0000”，

    “respMsg”: “”,

    “data”: {

        “msg”: {

            “altInfoList”: [

                    {

                        “altitemCn”: “”,

                        “altafter”: “”

                    }

              ]

        }

    }

}

9.发生变更的工商企业列表

请求JSON报文体：

{

    “insIdCd”: “00010001”,

    “qryRsltBgnDt”: “”

}

应答JSON报文体：

{

    “respCd”： “0000”，

    “respMsg”: “”,

    “data”: {

        “reserveFld”:

    }

}


报文签名规则([sign]生产方法)：

 

1.  报文前拼接签名密钥，后面拼接时间戳（毫秒）字符串：secret + body + ts

    secret: 签名密钥

    body: 请求JSON报文

    ts: 时间戳，毫秒

2.  使用SHA-256算法计算HASH值

3.  具体签名样例代码参照附录部分。

1. “快速接入”产品API使用教程请参考在线文档：

《“快速接入”产品API指南—接入指南》；


2. “快速接入”产品API安全调用过程请参考在线文档：

2.1《“快速接入”产品API指南—获取产品token》；

2.2《“快速接入”产品API指南—产品功能接口调用》；


3. “快速接入”产品API接口调用报文签名样例请参考在线文档：

《“快速接入”产品API指南—报文签名样例代码》；


4. “快速接入”产品API测试工具使用说明请参考在线文档：

《“快速接入”产品API指南—“快速接入”测试工具》。
咨询我们
业务咨询
姓名： 肖哲
电话： 021-20633440
邮箱： xiaozhe@unionpay.com
技术咨询
姓名： 赵希
电话： 021-20633170
邮箱： zhaoxi@unionpay.com
热门推荐