银联系统应答码查询

数据 收单机构 商户 开发者 发卡机构 快速接入
为便于银联系统接入用户动态解析系统报错信息,现将技术开放平台录入的应答码信息通过产品API接口的方式对外服务

接入服务商:银联技术开放平台

API ID:325

接口状态:正常

请咨询联系人
沙箱测试
在线调试

接口名称

获取产品token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: https://openapi.unionpay.com/upapi/respcodetest/token


生产地址: https://openapi.unionpay.com/upapi/respcode/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
过期时间 expire_in long M-必填 凭证有效时间,单位:秒
产品token token string M-必填 获取到的凭证; 凭证是字符串

接口名称

在线支付应答码

接口描述

获取在线支付应答码描述

接口地址

测试地址: https://open.unionpay.com/upapi/respcodetest/getACPRespDesc


生产地址: https://openapi.unionpay.com/upapi/respcode/getACPRespDesc

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCode string 20 M-必填 在线支付应答码

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 128 M-必填
响应数据 data map M-必填
应答码 respCode string 20 M-必填 请求中在线支付应答码
应答描述 respDesc string 800 M-必填 在线支付对应应答描述
解决方案 solution string 800 M-必填 错误处理解决方案
更新时间戳 crtTime timestamp M-必填 单位:毫秒

接口名称

机构系统应答码

接口描述

获取机构入网应答码描述

接口地址

测试地址: https://open.unionpay.com/upapi/respcodetest/getIJRespDesc


生产地址: https://openapi.unionpay.com/upapi/respcode/getIJRespDesc

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考附加板块“签名样例代码”部分。
时间戳 ts int M-必填 单位:毫秒。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCode string 20 M-必填 机构系统应答码

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 128 M-必填
应答码 data map 20 M-必填 响应数据
应答码 respCode string 20 M-必填 机构系统应答码
应答描述 respDesc string 800 M-必填 机构入网对应应答描述
解决方案 solution string 800 M-必填 应答码处理解决方案
更新时间戳 crtTime timestamp M-必填 单位:毫秒
应用对象

限定商户、机构用户

接入流程

1、目前该产品API仅面向特定的商户、机构提供服务,如有相关需求,请发送邮件至业务接口人说明相关使用需求;

2、商户、机构用户请提供相关银联入网证明材料;开发者用户请提供身份证相关信息;

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

应答码参照:
应答码 描述
0000 处理成功
0001 服务未定义
1000 错误的应答码
2000 未找到对应的应答码
8000 未知错误
9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联技术开放平台(open.unionpay.com)进行白名单登记。
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 您的签名密钥未设置,请登录银联技术开放平台(open.unionpay.com)确认相关配置
9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联技术开放平台(open.unionpay.com)提供的签名规则。
9912 您的报文格式有误,要求报文符合JSON数据格式
9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求
9914 您的报文无法解密,请检查您在银联技术开放平台(open.unionpay.com)上提供的RSA公钥是否正确。
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。
9991 银联技术开放平台系统内部错误:产品服务调用失败
9992 银联技术开放平台系统内部错误:产品服务系统未知错误
9993 银联技术开放平台系统内部错误:产品服务未注册至服务中心
9994 银联技术开放平台系统内部错误:产品服务参数错误

1.报文举例-获取产品调用token信息:


请求URL:

 

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

 

应答JSON报文体

{
“token”: “”,
“expire_in”:7200
}


2.报文举例- 在线支付应答码转换:


请求URL:

 

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

 

请求JSON报文体

{
“respCode”: “6154004”
}

 

应答JSON报文体

{
    “respCd”: “0000”,
    “respMsg”:“”,
    “data”: {
    “respCode”: “6154004”,
    “respDesc”: “交易通讯超时,请发起查询交易”
        }
}

 


3.报文举例-机构入网应答码转换:


请求URL:

 

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

 

请求JSON报文体

{
“respCode”: “40010”
}

  

应答JSON报文体

{
    “respCd”: “0000”,
    “respMsg”:“”,
    “data”: {
    “respCode”: “40010”,
    “respDesc”: “请通过营销QQ反馈银联测试人员处理”
        }
}



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

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


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

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

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


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

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


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

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

咨询我们
业务咨询
姓名: 田霖
电话: 021-20633145
邮箱: tianlin1@unionpay.com
技术咨询
姓名: 赵希
电话: 021-20633170
邮箱: zhaoxi@unionpay.com
热门推荐