商户信息查询
数据
收单机构
发卡机构
本产品为机构用户提供了基于商户号的商户信息查询服务。用户输入自身所属机构机构号及需要查询的商户号,接口返回商户中文名称、商户交易类型、收单机构标识码等基本信息。
服务对象

机构用户

产品详情

本产品为机构用户提供了基于商户号的商户信息查询服务。用户输入自身所属机构机构号及需要查询的商户号,接口返回商户中文名称、商户交易类型、收单机构标识码等基本信息。

该服务当前仅支持银联联机商户信息查询,且要求用户所属机构与查询商户间满足如下权限关系。(1)收单机构查询本机构收单的商户信息。(2)收单机构总公司查询其分支机构收单的商户信息。(4)收单机构的代理机构查询商户信息。(5)银联总公司查询所有商户信息。(3)银联分公司查询辖内商户信息。


接入流程

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

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

3.技术联调,可参照OpenAPI技术文档—接入指南》



具体开发接入请查看“商户信息查询 ”文档资源进行下载
应答码参照
应答码 描述 解决方案
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. 获取token

请求URL:

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


应答JSON报文体:

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


2. 商户基本信息查询

请求URL:

https://openapi.unionpay.com/upapi/mchntinfo/getMchntInfo?token=[token]&sign=[sign]&ts=[ts]


请求JSON报文体:
{
         "insIdCd": "00010000",
         "mchntCd": "T06440350658709"
}

应答JSON报文体

{
         "data": {
        "mchnt_cd": " 887451047840002 ",
        "mchnt_svc_tp": "00",
        "acpt_ins_id_cd": "48874500",
        "acq_access_ins_id_cd": "48870000",
        "acq_ins_id_cd": "48870000",
        "acq_region_cd": "4510",
        "cntry_cd": "156",
        "mchnt_cn_abbr": "齐鲁交通发展集团有限公司电子收费分公司",
        "mchnt_tp": "振华手机城陈琳",
        "cup_branch_ins_id_cd": "",
        "admin_division_cd": "",
        "mchnt_cn_nm": "齐鲁交通发展集团有限公司电子收费分公司",
        "mchnt_en_abbr": "",
        "mchnt_en_nm ": "",
        "mchnt_grp": "1",
        "mchnt_st": "1",
        "plat_ins_id_cd": "48870000",
        "real_mchnt_tp": "4784",
        "sys_mchnt_cd": "344277813",
        "region_cd": "370102",
        "pay_sys_bank_in": ""
    },
         "respCd": "0000",
         "respMsg": ""
}


1. OpenAPI使用教程请参考在线文档:

OpenAPI使用指南—接入指南


2. OpenAPI安全调用过程请参考在线文档:

2.1OpenAPI使用指南—获取产品token

2.2OpenAPI使用指南—产品功能接口调用


3. OpenAPI接口调用报文签名样例请参考在线文档:

OpenAPI使用指南—报文签名样例代码


4. OpenAPI测试工具使用说明请参考在线文档:

OpenAPI使用指南—OpenAPI测试工具



联系我们

业务咨询: 021-20633170

赵希

zhaoxi@unionpay.com

技术咨询: 021-20633521

张昊

zhanghao1@unionpay.com

咨询与服务