当前位置: 产品API > 数据 > 代付限额查询
产品介绍
  • 服务对象
    机构用户
  • 产品详情

    资费详情:

    本产品推广期为2017年10月01日至2019年12月31日,推广期内本产品可免费使用。推广期过后的收费标准将提前30个工作日在本平台另行公示。    

  • 应用场景

    银联代付可广泛应用于各行业,包括但不仅限于保险赔付及分红、农资产品收购、薪资发放、财税库银退税等领域。本接口可实时查询客户机构当日代付业务中的信用额度、预付额度和已用额度。

    1421138545726089711.png


应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    0000 成功 暂无
    1001 请求机构号异常 暂无
    2001 限额管控平台查询失败 暂无
    2002 该机构无代付限额信息 暂无
    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 您的签名密钥未设置,请登录银联开放平台 暂无
    9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。 暂无
    9912 您的报文格式有误,要求报文符合JSON数据格式 暂无
    9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求 暂无
    9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。 暂无
    9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。 暂无
    9991 银联开放平台系统内部错误:产品服务调用失败 暂无
    9992 银联开放平台系统内部错误:产品服务系统未知错误 暂无
    9993 银联开放平台系统内部错误:产品服务未注册至服务中心 暂无
    9994 银联开放平台系统内部错误:产品服务参数错误 暂无
接入流程
接入流程

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

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

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

        

技术指南

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

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


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

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

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


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

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


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

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

报文举例

1. 报文举例-获取token:


请求URL:

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

应答JSON报文体:

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


2.报文举例-查询代付限额


请求URL:

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

请求报文参数:

{

    "mchntCd":"77777777"
}


应答JSON报文体:

{
 “respCd”:“0000”,
 “respMsg”: “”,  
 "data":{
   “acctId”: “77777777”,
   “acctR0”: “100.00”,
   “acctR1”: “500.00”
   “acctR2”: “1000.00”
   “r0UpdTs”: “2018-08-23 00:00:00”
   “r1UpdTs”: “2018-08-23 00:00:00”
   “r2UpdTs”: “2018-08-23 00:00:00”
            
  } 
     
}


常见问题
  • 调用接口返回提示 {"respMsg":"限额管控平台查询失败","respCd":"2001"}

    1、系统无相关机构的限额数据信息,会出现相关错误;

    2、需联系业务接口人询问数据无法查询的原因。 

  • 如何使用沙箱测试?
  • 调用接口返回提示 {"respMsg":"body or sign is null.","respCd":"9905"}

    API接口需使用body部分传送JSON数据,故而HTTP请求的content-type需使用application/json,而不是application/x-www-form-urlencoded。

  • 如何计算机构目前的代付限额?

    答:本接口向机构用户返回六个代付限额信息,该机构的代付业务与银联直连下的信用额度R0、预付额度R1、已用额度R2,以及以上三个额度的更新时间。

    本接口得到的代付限额R=R0+R1-R2,即信用额度+预付额度-已用额度,代付限额会随着实际业务的进行而更新。

    需要注意的是,如果收单机构的代付业务通过银行与银联间连,那么本接口无法查询到这一部分的代付限额。

  • 机构代付限额问题,代付限额查询网页版?

    答:登录机构业务门户(portal.unionpay.com)平台:选择POS收单服务-机构分户额度查询;输入机构代码查询机构代付额度信息。

  • 机构代付限额问题,查询的是线下代付限额,还是银联在线支付的代付限额信息?

    答:代付限额信息查询现有两个接口:1、银联开放平台接口;2、银联在线支付的代付限额接口; 机构代付交易的总额度,不区分银联在线支付或者线下。

    现推荐使用银联开放平台接口。

  • 机构代付限额问题,机构SSO账号如何申请?

    答:登录UOSP的就是机构SSO账号,如果你们找不到的话:可以通过UOSP提交服务单申请一个机构用户名,UOSP路径如下:业务管理>商户及合作机构信息调整>代收付业务(代收代付订购等)信息调整

    如果无法登录UOSP申请机构用户名,请直接联系银联信息总中心:4008395516,告知信总服务人员,你们需要申请机构用户名,信总会提供相关申请材料。

文档下载
API接口
了解全局token
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/xeaap/token
测试地址
https://openapi.unionpay.com/upapi/xeaaptest/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/xeaap/queryaap
测试地址
https://openapi.unionpay.com/upapi/xeaaptest/queryaap
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。   
签名信息 sign string M-必填 详细签名算法可参考“技术指南”板块第3条。   
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。   
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
机构编码 acctId string M-必填 8-15位数字型字符串; 以json格式传递的post请求参数    该参数已配置预检规则
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 参考左侧菜单“应答码参照”   
应答消息 respMsg string M-必填 如果respCd不是0000,该字段解释了具体的出错原因。   
应答报文 data map C-依条件必填   
机构编码 issNm string M-必填 变长60位字符串   
信用额度R0 acctR0 string M-必填 银联为机构分配的额度(元)字符串   
预付额度R1 acctR1 string M-必填 机构付费提升的额度(元)字符串   
已用额度R2 acctR2 string M-必填 机构代付发出额度(元)字符串   
信用额度更新时间 r0UpdTs string M-必填 YYYY-MM-DD HH:mm:ss   
预付额度更新时间 r1UpdTs string M-必填 YYYY-MM-DD HH:mm:ss   
已付额度更新时间 r2UpdTs string M-必填 YYYY-MM-DD HH:mm:ss   
联系我们

业务咨询: 李菁原

021-20631550

lijingyuan@unionpay.com

技术咨询: 田霖

021-20633145

tianlin1@unionpay.com

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