银联权益信息
数据
收单机构
商户
开发者
发卡机构
查询、核销银联权益信息,并结合实际使用场景核销用户权益
服务对象

权益内容供应商、合作银行机构及其他合作平台

产品详情

针对权益内容供应商,支持权益产品内容的接入,实现服务全流程线上化。涉及的API接口主要包含权益的查询、核销已经订单状态通知。

针对合作银行机构及其他合作平台,支持权益的查询,输入要素为银行卡号及相关查询条件,返回该卡号包含的具体权益次数及有效期。

持卡人可通过云闪付APP,进行查询、核销银联权益信息,如下图:

untitled.bmp

应用场景

目前已经落地实现了多项权益的全流程线上服务,例如机场CIP、机场接送机、马术礼遇等。

以机场CIP为例:

1、用户在权益平台使用权益并且发起订单

2、用户完成支付

3、权益平台向供应商请求券码并展示

4、用户线下前往机场核销券码使用服务


产品亮点

     

为了更好面向持卡人提供权益综合服务,银联权益管理平台通过技术开放平台封装成数据接口,开放上线“银联权益信息”产品API,为开发者、权益合作商提供对外统一标准、统一流程的API调用服务。

        5.jpg

接入流程

1.调用该API时,若只需调用“获取token”“查询权益信息”“卡号查询权益”接口,只需点击本页面“业务申请”,并认真填写相关内容,待业务接口人审核通过后即可(审核周期为2-3个工作日);

2.如还需其它接口,请联系业务接口人说明相关使用需求,沟通确认后,请点击本页面“业务申请”,并认真填写相关内容,待业务接口人审核通过后即可(审核周期为2-3个工作日);

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

注意事项

1、非合作方用接口(接口不需要传递partner字段)可以直接通过业务申请使用;

2、合作方用接口(接口需要传递partner字段),因为合作方的权益可能涉及业务洽谈、商务谈判、技术对接、权益配置等流程,请先进行业务沟通后再进行API接入使用;

3、权益测试地址接口(tdctest.95516.com)存在网络防火墙,因此非合作方用接口可直接使用生产接口。


具体开发接入请查看“银联权益信息 ”文档资源进行下载
应答码参照
应答码 描述 解决方案
0000 处理成功 展开详情
暂无
0001 服务未定义,请检查您请求的URL 展开详情
暂无
8000 未知错误 展开详情
暂无
8001 请求参数不完整 展开详情
暂无
8002 请求参数有误 展开详情
暂无
8003 权益归属地有误 展开详情
暂无
8004 合作方信息有误 展开详情
暂无
8005 权益类型有误 展开详情
暂无
8006 卡信息有误或未读取出卡信息 展开详情
暂无
8007 该合作定义值无法获取到权益 展开详情
暂无
8008 未找到所需核销的权益信息或权益信息异常 展开详情
暂无
8009 权益余量不足,无法核销 展开详情
暂无
8010 根据合作定义值获取到的权益信息异常 展开详情
暂无
8011 重复核销权益,无法核销 展开详情
暂无
8012 未找到权益信息 展开详情
暂无
8013 该卡未查到权益或权益已用完 展开详情
暂无
8014 改权益已过期,无法核销 展开详情
暂无
8015 获取权益订单信息失败 展开详情
暂无
8016 获取订单附加信息失败 展开详情
暂无
8017 订单状态有误 展开详情
暂无
8018 订单附加信息有误,请确认附加信息是否正确(金额等参数是否传递正常) 展开详情
暂无
8099 请求数据越权 展开详情
暂无
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.OpenAPI使用教程请参考在线文档:

OpenAPI使用指南接入指南》

 

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

2.1OpenAPI使用指南获取产品token

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

 

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

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

 

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

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


联系我们

业务咨询: 021-20633047

汪一凡

wangyifan1@unionpay.com

技术咨询: 021-20633157

林英觉

linyingjue@unionpay.com

咨询与服务