受理业务国家查询
运营
收单机构
商户
开发者
发卡机构
银联国际受理业务开通国家和地区查询服务。
服务对象

机构、商户、开发者

产品详情

此产品为银联国际提供,通过与全球2000多家机构合作,目前银联卡全球受理网络已延伸到174个国家和地区,52个国家和地区发行了银联卡。银联国际正在为全球最大的持卡人群提供优质、高效、安全的跨境支付服务,并为越来越多境外银联卡持卡人提供日益便利的本地化服务。


此接口是根据国家代码查询银联覆盖全球174个国家和地区的相关银联产品和服务。

可以调用查询境外ATM机的取款点、手续费、或者享受银联的相关权益;支持展示银联刷卡贴士,告知用户如何在境外进行刷卡消费、境外取款、取款卡种限制,部分国家支持本地办理银联卡服务。


点击这里,立即体验。

手机扫码,立即体验:

受理业务国家查询.png

输入国家/代码示例:英国

应用场景

境外旅游或境外出差时可以快速便捷地找到支持银联服务的相关地点,不用提前准备攻略,也不用额外办理万事达或者visa信用卡,随时随地即可前往任何国家,享受银联支付的便捷。

接入流程

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

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

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


具体开发接入请查看“受理业务国家查询 ”文档资源进行下载
应答码参照
应答码 描述 解决方案
0000 处理成功。 展开详情
暂无
0001 服务未定义 展开详情
暂无
0002 国家与国家代码不能同时为空 展开详情
暂无
0003 大洲与大洲代码不能同时为空 展开详情
暂无
1000 查询条件错误 展开详情
暂无
2000 未查询到对应的国家信息 展开详情
暂无
8000 未知错误。 展开详情
暂无
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/businesscountry/token?app_id=[value]&app_secret=[value]


应答JSON报文体

{
    "respCd":"0000"
    "respMsg":"成功"
    "token": "fsddfssseessseee",
    "expire_in": 7200

}



2.报文举例-根据国家查询


请求URL:

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


请求报文参数:


{

“country”:”中国大陆”,
“countryCode”:”156”
}


应答JSON报文体:


“respCd”:”0000”,
“respMsg”:”Success”,
“data”:{
          “country”:”中国大陆”, 
          “countryCode”:”156”,
          “business”:”ATM、POS”,
          “currency”:”人民币”,
          “currencyCode”:”156”,
          “continent”:”亚洲”,
          “continentCode”:”1”  
}



3.报文举例-根据大洲查询


请求URL:

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


请求报文参数:


{
“continent”:” 亚洲”,
“continentCode”:”1”
}


应答JSON报文体:


{
“respCd”:”0000”,
“respMsg”:”Success”,
“data”:{
          countryList:[
           {
            “country”:”中国大陆”, 
            “countryCode”:”156”,
            “business”:”ATM、POS”,
            “currency”:”人民币”,
            “currencyCode”:”156”,
            “continent”:”亚洲”,
            “continentCode”:””
           },{
            “country”:”香港”, 
            “countryCode”:”344”,
            “business”:”ATM、POS”,
            “currency”:”港币”,
            “currencyCode”:”344”,
            “continent”:”亚洲”,
            “continentCode”:”1”
           },{…}
                     ]
    }
}


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

OpenAPI使用指南接入指南》

 

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

2.1OpenAPI使用指南获取产品token

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

 

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

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

 

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

OpenAPI使用指南—OpenAPI测试工具》


名称

代码

亚洲

1

欧洲

2

北美洲

3

南美洲

4

非洲

6

大洋洲

7


联系我们

业务咨询: 021-20633170

赵希

zhaoxi@unionpay.com

技术咨询: 021-20633170

赵希

zhaoxi@unionpay.com

咨询与服务