当前位置: 产品API > 数据 > 商户信息共享联防机制查询
产品介绍
  • 服务对象
    收单机构
  • 产品详情

    根据银发〔2019〕85号文有关要求,自2019年6月1日起,收单机构拓展特约商户时,应当通过中国支付清算协会或银行卡清算机构的特约商户信息管理系统查询其签约、更换收单机构情况和黑名单信息。


    收单机构在注册商户时可通过营业执照号或法定代表人证件号码及姓名查询商户历史签约信息及黑名单信息。对于同一营业执照号或者同一个法定代表人(负责人)的特约商户存在频繁更换收单机构、被收单机构多次清退或同时签约多个收单机构等异常情形的,收单机构应当谨慎将其拓展为特约商户。黑名单信息包括被列入风险可疑商户、被国家企业信用信息公示系统列为经营异常、被国家企业信用信息公示系统列入失信黑名单。列入风险可疑商户或被国家企业信用信息公示系统列入失信黑名单的,收单机构不得将其拓展为特约商户;被国家企业信用信息公示系统列为经营异常的,收单机构应当谨慎将其拓展为特约商户。



  • 产品亮点

    基于银联海量商户数据,为成员机构落实监管要求、加强特约商户管理提供系统支持

  • 应用场景

    收单成员机构拓展特约商户前,按照“先查询、后注册”的要求,通过接口查询该商户签约、更换收单机构情况和黑名单信息。


应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    0000 处理成功。 暂无
    1001 api值非法 暂无
    1002 查询条件非法 暂无
    1003 单次查询数量超过限制 暂无
    1004 请求数据异常 暂无
    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 银联开放平台系统内部错误:产品服务未注册至服务中心。 暂无
    9994 银联开放平台系统内部错误:产品服务参数错误。 暂无
接入流程
接入流程

1.如需申请该API,请点击本页面“业务申请”,并认真填写相关内容;

2.待业务接口人审核通过后即可调用该API,审核周期约为2-3个工作日;

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



报文举例

1. 获取token

请求URL:

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



应答JSON报文体:

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


2.  商户信息共享联防机制查询

请求URL:
https://openapi.unionpay.com/upapi/mhsiqs/query?token=[token]&sign=[sign]&ts=[ts]


请求JSON报文体:
{
  "list": [{
       "queryTp": "1",
       "licNo": "371300018019640",
       "artifCertifId": "",
       "artifNm": ""
  }]
}

应答JSON报文体

{
  "data": [{
       "acqInsNum": 2,
       "artifCertifId": "",
       "artifNm": "",
       "closeMchntList": [],
       "closeMchntNum": 0,
       "isInBlackList": "111",
       "licNo": "371300018019640",
       "mchntCnAbbr": "山东省临沂骏骐汽车贸易有限公司",
       "mircoMchntNum": 0,
       "queryTp": "1",
       "signMchntList": [{
            "mchntBussNm": "山东省临沂骏骐汽车贸易有限公司",
            "mchntOpenDt": "20170329"
       }, {
            "mchntBussNm": "临沂骏骐汽车贸易有限公司",
            "mchntOpenDt": "20160119"
       }, {
            "mchntBussNm": "临沂骏骐汽车贸易有限公司",
            "mchntOpenDt": "20100723"
       }],
       "signMchntNum": 5
  }],
  "respCd": "0000",
  "respMsg": ""
}


技术指南

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/mhsiqs/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/mhsiqs/query
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
查询列表 list array M-必填 目前仅支持单个营业执照号或者单个法人代表信息的查询   
查询类型 queryTp string M-必填 1-营业执照号查询;2-法人代表姓名 + 法人代表证件号查询   
营业执照号 licNo string C-依条件必填   
法人代表证件号 artifCertifId string C-依条件必填   
法人代表姓名 artifNm string C-依条件必填   
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 参考左侧菜单“应答码参照”   
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
查询类型 queryTp string M-必填   
营业执照号 licNo string M-必填   
法人代表证件号 artifCertifId string M-必填   
法人代表姓名 artifNm string M-必填   
商户名称 mchntCnAbb string M-必填   
是否列入黑名单 isInBlackList string M-必填 三位的位图,取值0或1,分别代表是否列入风险可疑商户、是否被国家企业信用信息公示系统列为经营异常、是否被国家企业信用信息公示系统列入失信黑名单。0代表不在黑名单中,1代表在黑名单中。   
共计查询到的商户记录数量 signMchntNum int M-必填   
入网商户列表 signMchntList array M-必填   
商户经营名称 mchntBussNm string M-必填   
入网时间 mchntOpenDt string M-必填   
共计查询到的退出记录数量 closeMchntNum int M-必填   
退出商户列表 closeMchntList array M-必填   
商户经营名称 mchntBussNm string M-必填   
退出时间 mchntCloseDt string M-必填   
涉及收单机构数量 acqInsNum int M-必填   
小微商户数量 mircoMchntNum int M-必填   
联系我们

业务咨询: 朱尔隆

021-20638211

zhuerlong@unionpay.com

技术咨询: 张昊

021-20633521

zhanghao1@unionpay.com

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