当前位置: 产品API > 数据 > 工商信息服务
产品介绍
  • 服务对象
    商户和机构用户,开发者用户不可用
  • 产品详情

    产品含三大类功能支持。

    信息核实:对用户录入的信息进行真假辨别,系统核对信息完毕后反馈。

    信息检索:对用户录入的查询要素进行信息补全反馈或查询列表反馈。

    动态跟踪:定制动态跟踪的企业列表,当企业工商信息发生变化时,动态通知用户,用户查询获取变更内容。

  • 产品亮点

    可靠

    银联系统与工商系统直接对接;
    高效
    可实现系统间对接,通过返回检索企业的相关信息,降低手工录入工商数据的错误,提高工作效率;
    可追踪
    支持动态跟踪企业信息变化,可满足金融机构对特定企业的关注诉求。

  • 应用场景

    金融收单
    主要适用于收单机构拓展商户及对商户资质进行审核的阶段。降低收单机构在经营过程中可能产生的商户拓展及审查风险、商户信用风险。

    反洗钱防范
    主要适用于金融机构在本机构开户过程中对商户或企业真实性的判定,用于反洗钱风险的识别和防范。

应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    0000 处理成功。 展开详情
    0001 调用成功,但包含错误信息 暂无
    0002 业务异常 暂无
    9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开发平台(https://open.unionpay.com/tjweb/user/info)进行白名单登记。 暂无
    9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开发平台(open.unionpay.com)提交申诉请求。 暂无
    9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。 暂无
    9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置。 暂无
    9905 请求参数值有误,请确认请求参数信息。 暂无
    9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。 暂无
    9907 app_id与app_secret验证失败。 暂无
    9908 您的Token已过期,请重新获取Token。 暂无
    9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。 暂无
    9910 您的签名密钥未设置,请登录银联开放平台(https://open.unionpay.com/tjweb/user/info)确认相关配置。 暂无
    9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。 暂无
    9912 您的报文格式有误,要求报文符合JSON数据格式。 暂无
    9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求。 暂无
    9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。 暂无
    9915 您的API调用额度已耗尽,需充值付费后补充调用额度。 暂无
    9916 您的API并发调用额度已耗尽,需联系管理员调整您的并发限额。 暂无
    9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。 暂无
    9991 银联开放平台系统内部错误:产品服务调用失败。 暂无
    9992 银联开放平台系统内部错误:产品服务系统未知错误。 暂无
    9993 银联开放平台系统内部错误:产品服务未注册至服务中心。 暂无
接入流程
接入流程

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

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

3. 如需调用该API,请点击本页面“业务申请”,并认真填写相关内容,待业务接口人审核通过后即可(审核周期为2-3个工作日);

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


报文举例

1.报文举例—获取产品token


请求URL:

https://openapi.unionpay.com/upapi/entinfo/token?app_id=[value]&app_secret=[value]

应答JSON报文体:

{
        “respCd”:“0000”
        “respMsg”:“成功”
        “token”: “”,
        “expire_in”: 7200
}


2.更新关注工商信息


请求URL:

https://openapi.unionpay.com/upapi/entinfo/updFollowingEntMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

    “insIdCd”: “00010001”,

    “followingReqTp ”: “001”,

    ……

}

应答JSON报文体:

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


3.验证工商信息


请求URL:

https://openapi.unionpay.com/upapi/entinfo/vfyEntMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

    “insIdCd”: “00010001”,

    “busLicense”: “”

}

应答JSON报文体:

{

    “respCd”: “0000”,

    “respMsg”: “”,

    “data”: {

        “msgVersionCd”: “”

    }

}


4.工商信息检索


请求URL:

https://openapi.unionpay.com/upapi/entinfo/entInfoQrMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

    “insIdCd”: “00010001”,

    “busLicense”: “”

}

应答JSON报文体:

{

    “respCd”: “0000”,

    “respMsg”: “”,

    “data”: {

        “msg”: {



        }

    }

}


5.关注信息检索


请求URL:

https://openapi.unionpay.com/upapi/entinfo/followedEntInfoQrMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

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

应答JSON报文体:

{

    “respCd”: “0000”,

    “respMsg”: “”,

    “data”: {

    “msgVersionCd”: “”

    }

}


6.股东信息列表检索


请求URL:

https://openapi.unionpay.com/upapi/entinfo/entShareholderListQrMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

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

应答JSON报文体:

{

    “respCd”: “0000”,

    “respMsg”: “”,

    “data”: {

        “msg”: {

            “shareholderList”: [

                {

                    “shareholderName”: “”,

                    “subconam”: “”

                }

            ]

    }

}

}


7.主要成员列表检索


请求URL:

https://openapi.unionpay.com/upapi/entinfo/entPersionnelListQrMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

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

应答JSON报文体:

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


8.变更信息列表


请求URL:

https://open.unionpay.com/upapi/entinfo/altInfoListQrMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

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

应答JSON报文体:

{

    “respCd”: “0000”,

    “respMsg”: “”,

    “data”: {

        “msg”: {

            “altInfoList”: [

                    {

                        “altitemCn”: “”,

                        “altafter”: “”

                    }

              ]

        }

    }

}


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


请求URL:

https://openapi.unionpay.com/upapi/entinfo/altEntListQrMsg?token=[value]&sign=[value]&ts=[value]

请求JSON报文体:

{

    “insIdCd”: “00010001”,

    “qryRsltBgnDt”: “”

}

应答JSON报文体:

{

    “respCd”: “0000”,

    “respMsg”: “”,

    “data”: {

        “reserveFld”:

    }

}


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

 

1.  报文前拼接签名密钥,后面拼接时间戳(毫秒)字符串:secret + body + ts

    secret: 签名密钥

    body: 请求JSON报文

    ts: 时间戳,毫秒

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



技术指南

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

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


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

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

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


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

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


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

“快速接入”产品API指南—“快速接入”测试工具


API接口
了解全局token
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/entinfo/token
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看   
用户唯一凭证密钥 app_secret string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填   
应答消息 respMsg string M-必填   
产品token token string C-依条件必填 获取到的凭证; 凭证是字符串   
过期时间 expire_in int C-依条件必填 凭证有效时间,单位:秒   
更新关注工商信息
接口描述
对机构自己关注的企业或个体户列表进行增加或删除操作
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/updFollowingEntMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号,当前支持的版本号为A1   
应答保留域 reserveFld string 20 O-选填   
验证工商信息
接口描述
验证企业或个体户信息是否存在、是否准确、是否匹配
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/vfyEntMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号,当前支持的版本号为A1   
应答保留域 reserveFld string 20 O-选填   
响应信息 msg array M-必填   
验证结果 vfyIn string 1 O-选填 0-验证通过 1-验证未通过   
工商信息检索
接口描述
通过营业执照号检索企业或个体户基本信息
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/entInfoQrMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 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   
关注信息检索
接口描述
机构自己获取自己关注的企业或个体户列表
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/followedEntInfoQrMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号,当前支持的版本号为A1   
应答保留域 reserveFld string 20 O-选填 无   
响应信息 msg map M-必填   
关注状态 followingIn string 1 M-必填 0-已关注 1-未关注   
股东信息列表检索
接口描述
对通过营业执照号码检索指定企业的股东信息请求的应答
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/entShareholderListQrMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 msgVersionCd string 2 M-必填 指明了报文的版本号,当前支持的版本号为A1   
应答保留域 reserveFld string 20 O-选填 无   
响应信息 msg map M-必填   
股东列表检索结果 shareholderList array O-选填   
股东姓名 shareholderName string 200 M-必填   
认缴出资额 subconam string 18 M-必填   
国别地区 countryCn string 128 M-必填   
出资方式个独 sconform string 200 M-必填 1-以个人财产出资,2-以家庭共有财产作为个人出资   
股东认缴信息 paidInInfoList array O-选填   
股东认缴出资额 sHSubconam string 18 M-必填   
认缴出资方式 conformCn string 128 M-必填   
认缴出资日期 condate string 8 M-必填 YYYYMMDD   
页码 queryPage string 4 M-必填   
总页数 recordPgCount string 4 M-必填   
当前页记录数 currentPgCount string 5 M-必填   
总记录数 recordCount string 5 M-必填   
主要成员列表检索
接口描述
通过营业执照号码检索企业的高管信息
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/entPersionnelListQrMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 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-必填   
变更信息列表
接口描述
通过营业执照号码检索该企业所做过的变更
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/altInfoListQrMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 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-必填   
发生变更的工商企业列表
接口描述
机构检索出指定日期范围内发生变更的企业列表
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/entinfo/altEntListQrMsg
测试地址
暂无
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 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 M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
报文版本号 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-必填   
联系我们

业务咨询: 肖哲

021-20633440

xiaozhe@unionpay.com

技术咨询: 赵希

021-20633170

zhaoxi@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号