当前位置: 产品API > 运营 > 受理业务国家查询
产品介绍
  • 服务对象
    机构、商户、开发者
  • 产品详情

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


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

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


  • 应用场景

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

应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    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.如需申请该API,请点击本页面“业务申请”,并认真填写相关内容;

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

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


报文举例

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. “快速接入”产品API使用教程请参考在线文档:

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


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

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

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


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

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


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

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


大洲名称代码对照

名称

代码

亚洲

1

欧洲

2

北美洲

3

南美洲

4

非洲

6

大洋洲

7


API接口
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/businesscountry/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/businesscountry/getByCountry
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
国家名称 country string C-依条件必填 国家名称和国家代码不能同时为空
国家代码 countryCode string C-依条件必填 国家名称和国家代码不能同时为空
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 参考左侧菜单“应答码参照”
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。
应答报文 data map C-依条件必填
国家名称 country string M-必填
国家代码 countryCode string M-必填
业务 business string M-必填
货币名称 currency string M-必填
货币代码 currencyCode string M-必填
大洲名称 continent string M-必填
大洲代码 continentCode string M-必填
根据大洲查询
接口描述
该接口为根据大洲名称或大洲代号查询接口。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/businesscountry/getByContinent
测试地址
敬请期待
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
大洲名称 continent string C-依条件必填 大洲名称和大洲代码不能同时为空
大洲代码 continentCode string C-依条件必填 大洲名称和大洲代码不能同时为空
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 参考左侧菜单“应答码参照”
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。
应答报文 data map C-依条件必填
开通国家列表 countryList string M-必填
国家名称 country string M-必填
国家代码 countryCode string M-必填
业务 business string M-必填
货币名称 currency string M-必填
货币代码 currencyCode string M-必填
大洲名称 continent string M-必填
大洲代码 continentCode string M-必填
联系我们

业务咨询: 赵希

021-20633170

zhaoxi@unionpay.com

技术咨询: 赵希

021-20633170

zhaoxi@unionpay.com

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