交易电子支付

中国银联电子支付与电子商务综合云平台云支付终端第三方应用接口规范第0.
20版中国银联二〇一六年八月十五日版本控制信息版本日期拟稿和修改说明0.
002012.
12.
25刘睿初稿0.
002013.
1.
10李安怡完成0.
002013.
1.
16刘睿重新定义参数,修改文档结构0.
002013.
1.
16李泽鹏定义参数类型0.
002013.
1.
17李安怡添加查询接口方法0.
002013.
4.
17李安怡添加pos信息查询接口,消费接口请求JSON参数增加磁道信息0.
012013.
12.
23何舟增加冲正交易自定义应答码0.
022014.
7.
22张少飞修改消费接口,增加POS签到和批结算0.
032014.
08.
20张少飞增加余额查询接口0.
042014.
08.
27张少飞修改农资收购相关交易接口0.
052014.
10.
23张少飞消费接口增加可选标题;增加消费撤销服务;完善签到接口,增加不需要打开银联支付即可完成签到的服务;0.
062014.
11.
03张少飞简化签到接口0.
072014.
11.
13张少飞消费增加资金归集模式;增加账户验证接口;增加交易统计接口;0.
082014.
12.
03张少飞修改批结算接口增加交易明细查询接口0.
092014.
12.
16张少飞增加退货交易接口0.
102015.
01.
14张少飞交易统计失败明细中增加消费撤销明细0.
112015.
06.
23张少飞增加多渠道和UPOP交易0.
122015.
08.
18张少飞增加接口调用说明,更新aidl文件0.
132015.
10.
10刘猛修改账户验证接口,适配资信app0.
142015.
10.
27刘猛增加内蒙社保缴费接口0.
152015.
12.
22刘猛增加助农取款接口;增加四川交罚接口字段0.
162016.
03.
14刘猛消费、转账添加签购单打印自定义标题0.
172016.
04.
12刘猛消费、水电煤缴费、助农取款接口返回IC卡信息,消费00模式支持应用商户号和应用终端号0.
182016.
05.
25刘猛转账、实时代付以及代付类交易支持应用商终号0.
192016.
05.
27刘猛新增内蒙贷款二期及新疆社保相关接口(4.
13-4.
15),原贷款查询、贷款试算、贷款还款接口废除(原4.
13-4.
15);全渠道实时代付删除手机号和短信验证码字段.
0.
202016.
07.
04刘猛增加钱包2.
0增值服务消费、撤销、退货接口(3.
12-3.
14)中国银联股份有限公司www.
chinaunionpay.
com云支付终端第三方应用支付接口规范-i-目录1概述.
11.
1目的.
11.
2阅读对象.
11.
3运行平台.
12第三方应用接入.
12.
1前提.
12.
2流程.
12.
2.
1支付.
12.
2.
2交易查询.
13收单交易接口规范.
23.
1消费交易接口.
23.
1.
1接口定义.
23.
1.
2请求参数.
23.
1.
3返回参数.
33.
2交易查询接口.
43.
2.
1接口定义.
43.
2.
2请求参数.
53.
2.
3返回参数.
53.
3POS签到接口63.
3.
1调用接口.
63.
3.
2请求参数.
63.
3.
3返回参数.
63.
4批结算接口.
73.
4.
1调用接口.
73.
4.
2请求参数.
73.
4.
3返回参数.
73.
5余额查询接口.
83.
5.
1调用接口.
83.
5.
2请求参数.
83.
5.
3返回参数.
83.
6消费撤销交易.
93.
6.
1调用接口.
9中国银联股份有限公司www.
chinaunionpay.
com云支付终端第三方应用支付接口规范-2-3.
6.
2请求数据:93.
6.
3应答数据:103.
7账户验证.
113.
7.
1调用接口.
113.
7.
2请求报文.
113.
7.
3应答报文.
123.
8交易统计.
133.
8.
1调用接口.
133.
8.
2应答数据:133.
8.
3sucList格式:133.
8.
4failList格式:143.
8.
5unkList格式:143.
8.
6voidList格式:153.
9交易明细查询.
153.
9.
1调用接口.
153.
9.
2请求报文.
163.
9.
3应答报文.
163.
9.
4txnList格式:163.
10退货交易.
173.
10.
1调用接口.
173.
10.
2请求报文.
173.
10.
3应答报文.
183.
11助农取款.
193.
11.
1调用接口.
193.
11.
2请求报文.
193.
11.
3应答报文.
193.
12增值服务消费.
203.
12.
1接口调用.
203.
12.
2请求数据.
203.
12.
3应答数据.
213.
13增值服务消费撤销.
223.
13.
1接口调用.
223.
13.
2请求数据.
223.
13.
3应答数据.
233.
14增值服务退货.
233.
14.
1接口调用.
23中国银联股份有限公司www.
chinaunionpay.
com云支付终端第三方应用支付接口规范-3-3.
14.
2请求数据.
243.
14.
3应答数据.
244多渠道交易接口规范.
254.
1委托建立.
254.
1.
1调用接口.
254.
1.
2请求报文.
254.
1.
3应答报文.
264.
2委托撤销.
274.
2.
1调用接口.
274.
2.
2请求报文.
274.
2.
3应答报文.
284.
3单笔代收.
284.
3.
1调用接口.
294.
3.
2请求报文.
294.
3.
3应答报文.
294.
4单笔代收撤销.
304.
4.
1调用接口.
304.
4.
2请求报文.
304.
4.
3应答报文.
314.
5实时代付.
314.
5.
1调用接口.
314.
5.
2请求报文.
314.
5.
3应答报文.
334.
6代付确认.
344.
6.
1调用接口.
344.
6.
2请求报文.
344.
6.
3应答报文.
344.
7结算统计.
354.
7.
1调用接口.
354.
7.
2请求报文.
354.
7.
3应答报文.
354.
8手机充值.
364.
8.
1接口调用.
364.
8.
2请求报文.
374.
8.
3应答报文.
37中国银联股份有限公司www.
chinaunionpay.
com云支付终端第三方应用支付接口规范-4-4.
9转账.
384.
9.
1接口调用.
384.
9.
2请求报文.
384.
9.
3应答报文.
384.
10账单查询.
394.
10.
1接口调用.
394.
10.
2请求报文.
394.
10.
3应答报文.
404.
11水电煤缴费.
404.
11.
1接口调用.
404.
11.
2请求报文.
404.
11.
3应答报文.
414.
12社保缴费.
424.
12.
1接口调用.
424.
12.
2请求数据.
424.
12.
3应答数据.
434.
13账单费用查询.
434.
13.
1接口调用.
434.
13.
2请求数据.
434.
13.
3应答数据.
444.
14缴费(有密)454.
14.
1接口调用.
454.
14.
2请求数据.
454.
14.
3应答数据.
464.
15缴费(无密)474.
15.
1接口调用.
474.
15.
2请求数据.
474.
15.
3应答数据.
485UPOP交易接口规范.
495.
1代收类交易.
495.
1.
1接口调用.
495.
1.
2请求数据.
495.
1.
3应答数据.
505.
2代付类交易.
515.
2.
1接口调用.
51中国银联股份有限公司www.
chinaunionpay.
com云支付终端第三方应用支付接口规范-5-5.
2.
2请求数据.
515.
2.
3应答数据.
525.
3交易撤销类交易.
525.
3.
1接口调用.
525.
3.
2请求数据.
535.
3.
3应答数据.
535.
4交易状态查询类交易.
535.
4.
1接口调用.
535.
4.
2请求数据.
545.
4.
3应答数据.
545.
5文件传输类交易.
555.
5.
1接口调用.
555.
5.
2请求数据.
555.
5.
3应答数据.
555.
6交易取消控制交易.
555.
6.
1接口调用.
565.
6.
2请求数据.
565.
6.
3应答数据.
566其它接口.
566.
1限额查询.
566.
1.
1接口调用.
566.
1.
2请求报文.
566.
1.
3应答报文.
566.
2限额设置.
576.
2.
1接口调用.
576.
2.
2请求报文.
576.
2.
3应答报文.
576.
3当日剩余额度查询.
576.
3.
1接口调用.
576.
3.
2请求报文.
576.
3.
3应答报文.
576.
4终端信息查询接口.
586.
4.
1调用接口.
586.
4.
2请求参数.
586.
4.
3返回参数.
58中国银联股份有限公司www.
chinaunionpay.
com云支付终端第三方应用支付接口规范-6-6.
5终端激活.
586.
5.
1接口调用.
596.
5.
2请求报文.
596.
5.
3应答报文.
597附录.
597.
1调用方法介绍.
597.
2参数解释.
617.
3用户交易类型定义.
627.
4返回应答码表.
627.
5AIDL文件657.
648域自定义域.
657.
6.
1格式说明.
657.
759域明细查询数据677.
7.
1格式说明.
677.
863域自定义域.
677.
8.
1交易明细用法格式说明.
677.
8.
2营销活动签购单备注栏信息格式说明.
687.
8.
2.
1仅自动折扣活动存在.
687.
8.
2.
2仅优惠券(不改终端模式)存在.
687.
8.
2.
3自动折扣+优惠券(不改终端模式)同时存在687.
962域自定义域.
687.
9.
1持卡人增值服务信息标准用法格式说明.
687.
9.
1.
1增值服务查询.
697.
9.
1.
2增值服务消费.
697.
9.
1.
3增值服务明细信息格式.
70中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-1-1概述1.
1目的银联第三方支付服务是一个基于银联云支付终端支付平台的支付服务,主要目的是方便外部合作伙伴使用云支付终端的服务,通过它向其他第三方应用提供交易数据同步服务以及异步处理结果返回服务,如:创建消费交易,同步扣除消费卡内金额等.
同时像第三方应用提供交易查询功能.
1.
2阅读对象云支付终端第三方(商户)应用的技术开发人员.
1.
3运行平台第三方应用运行于云支付终端上,通过接口实现银联卡支付服务和交易结果查询.
2第三方应用接入第三方应用、银联支付应用等都是安装于云支付终端之上.
第三方收银应用与银联支付应用通过IPC通信,采用AndroidBinder机制,数据格式是JSON,接口规范参考本文第三章.
2.
1前提第三方应用必须依赖银联银行卡支付系统,云POS终端设备必须已安装银联银行卡支付系统,并且系统启动登陆后,终端处于已签到状态.
2.
2流程2.
2.
1支付第三方应用呈现支付输入界面,供收银员输入交易金额等.
获取第三方应用名称、金额、交易索引号,组织JSON报文,向银联云支付银行卡支付应用发送交易报文请求.
银联银行卡支付客户端接收报文,向支付后台发送交易请求,后台处理结果返回给客户端,支付客户端将处理结果封装成报文发送回第三方应用,提供给第三方应用自行解析返回结果.
2.
2.
2交易查询第三方应用呈现查询输入界面,供管理员输入交易索引号等.
获取第三方应用名称、交易索引号、交易日期时间,组织JSON报文,向银联云支付银行卡支付应用发送查询报文请求.
银联银行卡支付客户端接收报文,向支付后台发送查询交易记录请求,后台查询结果返回给客户端,支付客户端将结果封装成报文发送回第三方应用,提供给第三方应用自行解析返回中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-2-结果.
3收单交易接口规范第三方收银应用与银联支付应用间采用RPCiBinder机制通信,数据格式为JSON格式.
3.
1消费交易接口3.
1.
1接口定义接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringpayCash(StringjsonData);3.
1.
2请求参数String类型,JSON数据格式,具体规范如下:字段名变量名出现要求类型(长度)说明交易模式modeMN201:普通消费;02:助农取款消费;03:农资收购消费;00:资金归集中行版模式;应用商户编号appMchntNoCN15mode=01时不填应用终端编号appTermNoCN8mode=01时不填应用IDappIDMN第三方应用的唯一标识,由银联指定.
应用名称appNameMAN或中文第三方应用名称,由第三方应用自行定义.
交易索引号transIndexCodeCans.
.
45mode=01时出现.
由第三方应用提供,此值用来标识一次交易请求,填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易金额transAmountMN(12)交易金额的币种均为人民币,以分为单位,前补0,示例:消费金额为100元,则交易金额应为000000010000.
持卡人证件号码idNoN6C当mode=00时必须填写.
身份证后6位数字,如果最中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-3-后一位是X,取前6位数字持卡人姓名cardHolderans…147C当mode=00时必须填写.
磁道3信息cardInfo3ONS磁条卡第三磁道信息磁道2信息cardInfo2ONS磁条卡第二磁道信息打印输出printON1无此域,选用默认值0.
0为打印,1为不打印.
标题titleOAS用于改变银联支付第三方消费服务的标题.
若无此域,则默认显示"消费".
交罚账号fineAccountCN四川交罚必填,其他情况不填签购单自定义标题title4BillC第三方应用签购单自定义标题.
如果上送此域,则签购单打印的标题为此值证件类型idTypeN2C01:身份证02:军官证03:护照04:回乡证05:台胞证06:警官证07:士兵证99:其它证件预留字段1exp1an…40Cmode=00时可选资信应用上送预留字段2exp2an…20Cmode=00时可选资信应用上送3.
1.
3返回参数域名变量名出现要求备注应用IDAppIdO第三方应用的唯一标识,由银联指定.
应用名称AppNameO第三方应用名称,由第三方应用自行定义.
交易类型TransTypeAN或中文返回的交易类型,中文显示.
交易金额TransAmountM交易金额的币种均为人民币,保留两位小数,示例:消费金额为100元,则交易金额应为00000010000.
交易日期TransDateM支付系统的处理交易成功的日期.
交易时间TransTimeM支付系统的处理交易成功的时间.
响应码RespCodeM支付系统返回给第三方应用的应答码,请参中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-4-照本文4.
3章所述.
响应描述RespDescC当rspCode等于'00'时存在,支付系统返回给第三方应用的应答码的对应中文解释,请参照本文4.
3章所述.
操作员编号OptCodeC操作员号只可能是01-98,普通操作员登陆成功签到后才能使用第三方应用,请参照本文2.
1章.
银行卡号CardNumM前5位数字和末4位数字显示,其他位数显示为*.
批次号BatchNumM交易中心返回的6位批次号,每批结算一次批次号加一.
交易凭证号CertNumMPOS中心系统流水号交易参考号ReferCodeM12位交易参考号是交易中心返回的随机编码,不会重复.
商户名称mchntNameM商户号mchntNoM终端号termNoM收单标识acqNoM发卡行标识issNoM收单行名称acq_nameM发卡行名称iss_nameM受理方标识码acqInsCodeM卡序列号cardSeqNoC当POS能够获得该值时存在卡有效期expDateC具有有效期的卡存在交易授权码authNoC交易承兑时由发卡行自定总计金额totalM冲正原因码revReasonCodeC当rspCode等于'E1'时存在冲正流水号traceNoC当rspCode等于'E1'时存在失败信息responseTextC当rspCode不等于'00'时存在IC卡信息icCardInfoCIC卡交易存在预留字段1exp1Cmode=00且上送时存在预留字段2exp2Cmode=00且上送时存在签名结果字段signatureC对报文上述所有字段的签名结果备注域referenceC优惠信息,如"CUP本次优惠38000.
01元实付62000.
00元"3.
2交易查询接口消费交易使用用法一时可以使用此接口进行交易查询.
3.
2.
1接口定义接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringgetPayInfo(StringjsonData)中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-5-3.
2.
2请求参数String类型,JSON数据格式,具体规范如下:字段名变量名出现要求类型(长度)说明应用IDappIDMN第三方应用的唯一标识,由银联指定.
应用名称appNameMAN或中文第三方应用名称,由第三方应用自行定义.
交易索引号transIndexCodeMans.
.
45此值填写交易发起时的索引号,用来查询一次交易请求,和交易日期配合使用.
交易请求日期reqTransDateMYYMMDD(6)第三方交易发起请求的日期,此值限制交易索引.
交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现3.
2.
3返回参数字段名变量名出现要求类型说明应用IDappIDMN第三方应用的唯一标识,由银联指定.
应用名称appNameMAN或中文第三方应用名称,由第三方应用自行定义.
交易类型transTypeMAN或中文返回的交易类型,中文显示.
交易索引号transIndexCodeMans.
.
45此值同第三方请求的交易索引号,返回值和请求值相同交易请求日期reqTransDateMYYMMDD(6)第三方交易发起请求的日期交易请求时间reqTransTimeMHhmmss(6)第三方交易发起请求的时间交易应答日期transDateMYYMMDD(6)支付系统的处理交易成功的日期.
交易应答时间transTimeMHhmmss(6)支付系统的处理交易成功的时间.
返回码rspCodeMAS…6支付系统返回给第三方应用的应答码,请参照本文4.
3中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-6-章所述.
返回码中文解释responseTextM中文支付系统返回给第三方应用的应答码的对应中文解释,请参照本文4.
3章所述.
交易金额transAmountON(12)查询的交易请求的金额,保留两位小数,示例:消费金额为100元,则交易金额应为00000010000.
3.
3POS签到接口3.
3.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringsignIn(StringjsonData)3.
3.
2请求参数String类型,JSON数据格式,具体规范如下:字段名变量名出现要求属性备注应用商户编号appMchntNoCN15助农取款、农资收购交易必填应用终端编号appTermNoCN8助农取款、农资收购交易必填应用IDappIDMN第三方应用的唯一标识,由银联指定.
应用名称appNameMANS1.
.
60第三方应用应用名称操作员编号operatorNoMN2实体终端普通操作员编号操作员密码operatorPwdMN4实体终端普通操作员密码3.
3.
3返回参数字段名变量名出现要求属性备注应用商户编号appMchntNoCN15应用终端编号appTermNoCN8应用IDappIDM应用名称appNameMANS1.
.
60交易类型transTypeMAN或返回的交易类型,中文中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-7-中文显示.
交易日期transDateMN4交易时间transTimeMN6应答码rspCodeM应答信息responseTextMANS1.
.
603.
4批结算接口仅在支付模式用法二和用法三时,需要先调用此接口,进行批结算.
支付模式用法一,不需要调用此接口.
3.
4.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:Stringsettlement(StringjsonData)3.
4.
2请求参数String类型,JSON数据格式,具体规范如下:字段名变量名出现要求属性备注应用商户编号appMchntNoCN15应用终端编号appTermNoCN8应用IDappIDM应用名称appNameMANS1.
.
603.
4.
3返回参数字段名变量名出现要求属性备注应用商户编号appMchntNoMN15应用终端编号appTermNoMN8应用IDappIDM应用名称appNameMANS1.
.
60商户名称mchntNameMANS1.
.
60交易类型transTypeMAN或中文返回的交易类型,中文显示.
交易时间DateTimeMN10操作员编号operatorIdMN2自动签退标识auto_signoutMN1打印凭条标识detail_printMN1应答码rspCodeM中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-8-应答信息responseTextMANS1.
.
60交易批次号batchNoMN6内卡对账信息inCardMANS1.
.
60内卡消费统计inSaleM"消费"内卡消费笔数inSaleSumMN3内卡消费金额inSaleAmountMN12内卡退货统计inRefundM"退货"内卡退货笔数inRefundSumMN3内卡退货金额inRefundAmountMN12外卡对账信息wildCardMANS1.
.
60外卡消费统计wildSaleM"消费"外卡消费笔数wildSaleSumMN3外卡消费金额wildSaleAmountMN12外卡退货统计wildRefundM"退货"外卡退货笔数wildRefundSumMN3外卡退货金额wildRefundAmountMN123.
5余额查询接口3.
5.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringbalanceQuery(StringjsonData)3.
5.
2请求参数String类型,JSON数据格式,具体规范如下:字段名变量名出现要求属性备注磁道2数据cardInfo2CNS磁条卡第二磁道信息磁道3数据cardInfo3CNS磁条卡第三磁道信息3.
5.
3返回参数字段名变量名出现要求备注响应码rspCodeM响应信息responseTextM卡片余额balanceAmountM当rspCode='00'时存在;保留两位小数,示例:消费金额为100元,则交易金额应为00000010000.
密码键盘显示pinpadShowM是否将余额显示在密码键盘上.
0中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-9-为显示,1为不显示.
商户名称mchntNameM商户号mchntNoM终端号termNoM收单标识acqNoM发卡行标识issNoM收单行名称acq_nameM发卡行名称iss_nameM受理方标识码acqInsCodeM银行卡号cardNoM卡序列号cardSeqNoC当POS能够获得该值时存在操作员编号operatorNoM交易类型transTypeM卡有效期expDateC具有有效期的卡存在批次号batchNoM交易凭证号voucherNoMPOS中心系统流水号交易日期dateM交易时间timeM交易参考号referNoM3.
6消费撤销交易3.
6.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringconsumeCancel(StringjsonData)3.
6.
2请求数据:域名变量名出现要求属性备注应用商户编号appMchntNoCN15助农取款、农资收购交易必填应用终端编号appTermNoCN8助农取款、农资收购交易必填应用IDappIDMN第三方应用的唯一标识,由银联指定.
应用名称appNameMANS1.
.
60第三方应用名称,由第三方应中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-10-用自行定义.
交易模式modeMN2第三方支付交易填写"01";助农取款消费撤销填写"02";农资收购消费撤销填写"03";银行卡号panCN16.
.
19银行卡主帐号,第三方应用提供刷卡/插卡功能时出现磁道2数据track2DataC第三方应用提供刷卡/插卡功能时出现磁道3数据track3DataC第三方应用提供刷卡/插卡功能时,终端能读取第3磁道时出现主管操作员密码operatorPwdMN6原交易凭证号oriTraceNoMN6撤销的原消费交易凭证号卡片序列号pbocCsnC第三方应用提供插卡功能时出现;打印输出printON1无此域,选用默认值0.
0为打印,1为不打印.
标题titleOAS用于改变银联支付第三方消费撤销服务的标题.
若无此域,则默认显示"消费撤销".
3.
6.
3应答数据:域名变量名出现要求备注应答码rspCodeM应答信息responseTextM商户名称mchntNameC应用商户名称商户号mchntNoM应用商户号终端号termNoM应用终端号收单标识acqNoC应答码为"00"时出现发卡行标识issNoC应答码为"00"时出现收单行名称acq_nameC应答码为"00"时出现发卡行名称iss_nameC应答码为"00"时出现受理方标识码acqInsCodeC应答码为"00"时出现银行卡号cardNoC应答码为"00"时出现卡序列号cardSeqNoC应答码为"00"且为IC卡交易时出现操作员编号operatorNoC应答码为"00"时出现交易类型transTypeC应答码为"00"时出现卡有效期expDateC应答码为"00"时出现批次号batchNoC应答码为"00"时出现交易凭证号traceNoC应答码为"00"时出现交易日期dateC应答码为"00"时出现中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-11-交易时间timeC应答码为"00"时出现交易授权码authNoC交易承兑时由发卡行自定应答码为"00"时出现交易参考号referNoC应答码为"00"时出现交易金额amountC交易金额的币种均为人民币,保留两位小数,示例:消费金额为100元,则交易金额应为00000010000.
冲正原因码revReasonCodeC当rspCode等于'E1'时存在冲正流水号traceNoC当rspCode等于'E1'时存在应用IDappIDO应用名称appNameO3.
7账户验证3.
7.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringaccountVerify(StringjsonData)3.
7.
2请求报文域名变量名属性出现要求备注主帐号pann…19M银行卡号第二磁道数据track2Dataans…35C银行卡出现且存在二磁道信息时出现第三磁道数据track3Dataans…104C银行卡出现且存在三磁道信息时出现模式modeN2M00:终端只读取卡号,由发卡方返回持卡人姓名;01:终端输入持卡人姓名和身份证号码,发卡方返回校验结果.
应答码为00表示验证通过,其它则验证失败.
持卡人证件号码idNoN6C证件号码填全持卡人姓名cardHolderans…147C当mode等于"01"时必须填写.
证件类型idTypeN2C01:身份证02:军官证中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-12-域名变量名属性出现要求备注03:护照04:回乡证05:台胞证06:警官证07:士兵证99:其它证件预留字段1exp1an…40C三项标识衍生码预留字段2exp2an…20C资信机构标识码/金融机构标识码交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现3.
7.
3应答报文域名变量名属性出现要求备注交易流水号traceNon6C本地交易时间localTimen6Chhmmss本地交易日期localDaten4CMMDD检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息银行卡号pann…19C银行卡主帐号持卡人姓名revNameans…147C当mode等于"00"时存在受卡机终端标识码posTermIdans8M终端代码受卡方标识码posMchntIdans15M商户代码商户名称mchntNameans…60M商户名称系统受理时间sysAccDaten14M中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-13-域名变量名属性出现要求备注预留字段1an…40C三项标识衍生码预留字段2an…20C资信机构标识码/金融机构标识码签名结果字段signatureC对报文上述所有字段的签名结果3.
8交易统计3.
8.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringdealStatics(StringjsonData)域名变量名出现要求属性备注统计模式modeMN202:资金归集业务统计查询日期dateMN8YYYYMMDD3.
8.
2应答数据:域名变量名出现要求属性备注POS商户编号posMchntNoMN15POS终端编号posTermNoMN8应答码rspCodeMan4应答信息responseTextMans.
.
20成功明细sucListMJson数据格式,见3.
9.
3定义失败明细failListMJson数据格式,见3.
9.
4定义付款状态未知明细unkListMJson数据格式,见3.
9.
5定义3.
8.
3sucList格式:域名参数名称属性出现要求备注应答码rspCodeans3M交易状态transStatusM"成功"转出卡号outPanN16…19M原消费交易卡号转入卡号revPanN16…19M原代付交易卡号交易金额txnAmtMN12交易金额的币种均为人民币,保留两位中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-14-域名参数名称属性出现要求备注小数,示例:100元,则交易金额应为00000010000.
流水号traceNoN6M原消费交易流水号批次号batchNoN6M原消费交易批次号订单号orderIdM代付交易商户订单号交易时间tsmDateTimeN14MYYYYMMDDhhmmss3.
8.
4failList格式:域名参数名称属性出现要求备注应答码rspCodeans3M交易状态transStatusM"已撤销"或者"未撤销"转出卡号outPanN16…19M原消费交易卡号转入卡号revPanN16…19M原代付交易卡号交易金额txnAmtMN12交易金额的币种均为人民币,保留两位小数,示例:100元,则交易金额应为00000010000.
流水号traceNoN6M原消费交易流水号批次号batchNoN6M原消费交易批次号订单号orderIdM代付交易商户订单号交易时间tsmDateTimeN14MYYYYMMDDhhmmss消费撤销明细voidListMJson数据格式,见4.
6.
6定义3.
8.
5unkList格式:域名参数名称属性出现要求备注应答码rspCodeans3M交易状态transStatusM"付款状态未知,待查询"中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-15-域名参数名称属性出现要求备注转出卡号outPanN16…19M原消费交易卡号转入卡号revPanN16…19M原代付交易卡号交易金额txnAmtMN12交易金额的币种均为人民币,保留两位小数,示例:100元,则交易金额应为00000010000.
流水号traceNoN6M原消费交易流水号批次号batchNoN6M原消费交易批次号订单号orderIdM代付交易商户订单号交易时间tsmDateTimeN14MYYYYMMDDhhmmss3.
8.
6voidList格式:域名参数名称属性出现要求备注应答码rspCodeans3M应答信息responseTextAns.
.
40M银行卡号cardNoN16…19M消费撤销交易卡号交易金额txnAmtN12M单位为分,例如:000000001234表示12.
34元流水号traceNoN6M批次号batchNoN6M授权码authNoN6M检索参考号retrvlRefNoN12M交易日期transDateN4MMMDD交易时间transTimeN6Mhhmmss3.
9交易明细查询3.
9.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-16-接口方法:StringdetailQuery(StringjsonData)3.
9.
2请求报文域名变量名出现要求属性备注应用商户编号appMchntNoCN15仅限助农取款、农资收购交易填写应用终端编号appTermNoCN8仅限助农取款、农资收购交易填写应用IDappIDM应用名称appNameM3.
9.
3应答报文域名变量名出现要求备注响应码rspCodeM响应信息responseTextM商户名称mchntNameM商户号mchntNoM终端号termNoM批次号batchNoM查询时间dateTimeM交易列表txnListM3.
9.
4txnList格式:域名参数名称出现要求备注凭证号voucherM交易流水号交易类型typeMS:消费T:分期付款消费B:积分消费E:电子现金消费R:退货P:预授权完成(请求)C:预授权完成(通知)Q:圈存类、充值类交易中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-17-域名参数名称出现要求备注卡号cardNumberM金额amountM交易金额的币种均为人民币,保留两位小数,示例:100元,则交易金额应为00000010000.
授权码authNoM交易时间tsmDateTimeOmmddhhmmss3.
10退货交易3.
10.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringreturnGoods(StringjsonData)3.
10.
2请求报文域名变量名出现要求备注应用商户编号appMchntNoC助农取款、农资收购交易必填应用终端编号appTermNoC助农取款、农资收购交易必填应用IDappIDM应用名称appNameM主管操作员密码operatorPwdM原交易参考号retrvlRefNoM请求时同原始交易,除电子现金卡以外需上送原交易日期transDateMMMDD交易模式modeM第三方支付交易填写"01";助农取款消费撤销填写"02";农资收购消费撤销填写"03";第二磁道track2DataC银行卡出现且存在二磁道信息时出现,在手机芯片交易中如存在二磁道信息,则该域必须出现且被加密保护第三磁道track3DataC银行卡出现且存在三磁道信息时中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-18-出现,在手机芯片交易中如存在三磁道信息,则该域必须出现且被加密保护主账户cardNoC当22域指明非磁条输入且可判卡号,手机芯片交易该域出现打印输出printO无此域,选用默认值0.
0为打印,1为不打印.
标题titleO用于改变银联支付第三方退货交易的标题.
若无此域,则默认显示"退货".
3.
10.
3应答报文域名变量名出现要求备注应答码rspCodeM应答信息responseTextM商户名称mchntNameC应用商户名称商户号mchntNoM应用商户号终端号termNoM应用终端号收单标识acqNoC应答码为"00"时出现发卡行标识issNoC应答码为"00"时出现收单行名称acqNameC应答码为"00"时出现发卡行名称issNameC应答码为"00"时出现受理方标识码acqInsCodeC应答码为"00"时出现银行卡号cardNoC应答码为"00"时出现卡序列号pbocCsnC应答码为"00"且为IC卡交易时出现操作员编号operatorNoC应答码为"00"时出现交易类型transTypeC应答码为"00"时出现卡有效期expDateC应答码为"00"时出现批次号batchNoC应答码为"00"时出现交易凭证号traceNoC应答码为"00"时出现交易日期transDateC应答码为"00"时出现交易时间transTimeC应答码为"00"时出现交易授权码authNoC交易承兑时由发卡行自定应答码为"00"时出现中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-19-交易参考号retrvlRefNoC应答码为"00"时出现交易金额transAmountC12位数字,单位为分应答码为"00"时出现应用IDappIDO应用名称appNameO3.
11助农取款3.
11.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringwithDrawal(StringjsonData)3.
11.
2请求报文域名变量名出现要求属性备注应用商户编号appMchntNoMN15应用终端编号appTermNoMN8应用IDappIDM应用名称appNameMANS1.
.
60交易金额transAmountMANS1.
.
13交易索引号transIndexCodeMans.
.
45填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易请求日期reqTransDateMN6交易请求时间reqTransTimeMN63.
11.
3应答报文域名变量名出现要求备注响应码rspCodeM响应描述rspDescC当rspCode等于'00'时存在失败信息responseTextC当rspCode不等于'00'时存在商户名称mchntNameM中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-20-商户号mchntNoM终端号termNoM收单标识acqNoM发卡行标识issNoM收单行名称acq_nameM发卡行名称iss_nameM受理方标识码acqInsCodeM银行卡号cardNoM卡序列号cardSeqNoC当POS能够获得该值时存在操作员编号operatorNoC交易类型transTypeM卡有效期expDateC具有有效期的卡存在批次号batchNoM交易凭证号voucherNoMPOS中心系统流水号交易日期dateM交易时间timeM交易授权码authNoC交易承兑时由发卡行自定交易参考号referNoM交易金额amountM小数点表示的金额IC卡应答数据icRelateDateCIC卡交易时存在总计金额totalM应用IDappIDO应用名称appNameOIC卡信息icCardInfoCIC卡交易存在3.
12增值服务消费3.
12.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringwalletSec(Stringdata);3.
12.
2请求数据交易金额transAmountn12M12位定长数字,单位为分;例如000000001234表示12.
34元中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-21-交易模式transModen2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNon15C交易模式=02时出现应用终端编号appTermNon8C交易模式=02时出现应用IDappIDans.
.
45C交易模式=02时出现应用名称appNameans.
.
60C交易模式=02时出现交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易类型transTypean6M取值:CPA002优惠券消费3.
12.
3应答数据域名变量名属性出现要求备注应答码rspCodean.
.
4M交易应答码无优惠券信息时返回"E10"应答信息responseTextans.
.
40M应答码对应的简要描述信息商户名称mchntNameans…60M商户编号mchntNoans15M终端编号termNoans8M操作员编号operatorNon2C发卡行号issNon4C发卡行名称issNameans.
.
40C银行卡号cardNon…19C银行卡主账号收单行号acqNon4C收单行名称acqNameans.
.
40C卡有效期expiredDaten4C批次号batchNon6C交易凭证号traceNon6C授权码authNoan6C检索参考号retrvlRefNoan12CPOS中心流水号受卡方所在地时间localTimen6Chhmmss受卡方所在地日期localDaten4CMMDD中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-22-交易金额transAmountn12C12位定长数字,单位为分交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
62域field62ans…512C增值服务信息,格式见附录7.
9说明63域field63ans…512M自定义域,格式见附录7.
8说明交易类型transTypean6CIC卡应答数据field55ans…255C当为IC卡交易时存在系统受理时间sysAccDaten14M3.
13增值服务消费撤销3.
13.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringwalletSecRevoke(Stringdata);3.
13.
2请求数据交易金额transAmountn12M同原始交易应答报文交易模式transModen2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNon15C交易模式=02时出现应用终端编号appTermNon8C交易模式=02时出现应用IDappIDans.
.
45C交易模式=02时出现应用名称appNameans.
.
60C交易模式=02时出现交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
原交易检索参考号origRetrvlRefNoan12M原消费交易参考号交易类型transTypean6M取值:CPA004优惠券消费撤销中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-23-3.
13.
3应答数据域名变量名属性出现要求备注应答码rspCodean.
.
4M交易应答码撤销交易如原消费交易已经退货返回"E11"应答信息responseTextans.
.
40M应答码对应的简要描述信息商户名称mchntNameans…60M商户编号mchntNoans15M终端编号termNoans8M操作员编号operatorNon2C发卡行号issNon4C发卡行名称issNameans.
.
40C银行卡号cardNon…19C银行卡主账号收单行号acqNon4C收单行名称acqNameans.
.
40C卡有效期expiredDaten4C批次号batchNon6C交易凭证号traceNon6C授权码authNoan6C检索参考号retrvlRefNoan12CPOS中心流水号受卡方所在地时间localTimen6Chhmmss受卡方所在地日期localDaten4CMMDD交易金额transAmountn12C12位定长数字,单位为分交易类型transTypean6CIC卡应答数据field55ans…255C当为IC卡交易时存在系统受理时间sysAccDaten14M63域field63ans…512M自定义域,格式见附录7.
8说明3.
14增值服务退货3.
14.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-24-接口方法:StringwalletSecReturn(Stringdata);3.
14.
2请求数据原交易日期origTransDaten4M交易类型transTypean6M取值:CPT016交易金额transAmountn12M交易模式transModen2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNon15C交易模式=02时出现应用终端编号appTermNon8C交易模式=02时出现应用IDappIDans.
.
45C交易模式=02时出现应用名称appNameans.
.
60C交易模式=02时出现交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易类型transTypean6M取值:CPA006优惠券退货3.
14.
3应答数据域名变量名属性出现要求备注应答码rspCodean.
.
4M交易应答码退货交易原消费交易已经撤销返回"E12"应答信息responseTextans.
.
40M应答码对应的简要描述信息商户名称mchntNameans…60M商户编号mchntNoans15M终端编号termNoans8M操作员编号operatorNon2C发卡行号issNon4C发卡行名称issNameans.
.
40C银行卡号cardNon…19C银行卡主账号收单行号acqNon4C中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-25-收单行名称acqNameans.
.
40C卡有效期expiredDaten4C批次号batchNon6C交易凭证号traceNon6C检索参考号retrvlRefNoan12CPOS中心流水号受卡方所在地时间localTimen6Chhmmss受卡方所在地日期localDaten4CMMDD交易金额transAmountn12C12位定长数字,单位为分交易类型transTypean6CIC卡应答数据field55ans…255C当为IC卡交易时存在系统受理时间sysAccDaten14M63域field63ans…512M自定义域,格式见附录7.
8说明4多渠道交易接口规范4.
1委托建立4.
1.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringcreateCommission(StringjsonData);4.
1.
2请求报文数据元参数名称类型请求备注第二磁道数据track2Dataans…37C磁条卡第二磁道数据第三磁道数据track3Dataans…104C磁条卡第三磁道数据用户号码类型userNumTypeans2M参考《多渠道平台接入规范-第五部分》附录F用户号码userNumans…40M用户号码地区编码userNumAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-26-数据元参数名称类型请求备注用户号码附加地区编码userNumAddAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C支付方式标志payModeCoden1M"0":主动定向或非定向"2":委托商户最高限制金额maxAmountans…13C交易金额的币种均为人民币,单位为元,保留两位小数,如12.
34元.
仅在委托商户时该子域值有效最低限制金额minAmountans…13C交易金额的币种均为人民币,单位为元,保留两位小数,仅在委托商户时该子域值有效报文示例:{"payModeCode":"2","minAmount":"11.
11","userNum":"18600010001","track3Data":"996225880000000000001=50910000987654321","userNumType":"01","maxAmount":"22.
22","track2Data":"6225880000000000001=50910000987654321","userNumAddAreaCode":"0000","userNumAreaCode":"7901"}4.
1.
3应答报文数据元参数名称类型出现要求备注POS终端号termIdans8MPOS终端代码POS商户号mchntIdans15MPOS商户代码响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息商户名称mchntNameans…20M商户名称操作员号operatorNon2M操作员编号收单行标识acqNoan11C发卡行标识issNoan11C收单行名称acqNameans…60C发卡行名称issNameans…60C交易流水号traceNoan6C检索参考号retrvlRefNoan12C交易发起方系统给予中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-27-数据元参数名称类型出现要求备注交易的系统检索参考号受卡方交易时间localTimen6Chhmmss受卡方交易日期localDaten4CMMDD主帐号cardNon…19C银行卡号交易类型transTypeansC用户号码userNumans…40C4.
2委托撤销4.
2.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringundoCommission(StringjsonData);4.
2.
2请求报文数据元参数名称类型请求备注第二磁道数据track2Dataans…37C磁条卡第二磁道数据第三磁道数据track3Dataans…104C磁条卡第三磁道数据用户号码类型userNumTypeans2M参考《多渠道平台接入规范-第五部分》附录F用户号码userNumans…40M用户号码地区编码userNumAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C用户号码附加地区编码userNumAddAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C支付方式标志payModeCoden1M"0":主动定向或非定向"2":委托商户最高限制金额maxAmountans…13C交易金额的币种均为人民币,单位为元,保留两位小数,如12.
34元.
仅在委托商户时该子域值有效中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-28-数据元参数名称类型请求备注最低限制金额minAmountans…13C交易金额的币种均为人民币,单位为元,保留两位小数,仅在委托商户时该子域值有效报文示例:{"track2Data":"6225880000000000001=50910000987654321","track3Data":"996225880000000000001=50910000987654321","userNumType":"01","userNum":"18600010001","minAmount":"11.
11","maxAmount":"22.
22","payModeCode":"2","userNumAddAreaCode":"0000","userNumAreaCode":"7901"}4.
2.
3应答报文数据元参数名称类型出现要求备注POS终端号termIdans8MPOS终端代码POS商户号mchntIdans15MPOS商户代码响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息商户名称mchntNameans…20M商户名称操作员号operatorNon2M操作员编号收单行标识acqNoan11C发卡行标识issNoan11C收单行名称acqNameans…60C发卡行名称issNameans…60C交易流水号traceNoan6C检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号受卡方交易时间localTimen6Chhmmss受卡方交易日期localDaten4CMMDD主帐号cardNon…19C银行卡号交易类型transTypeansC用户号码userNumans…40C4.
3单笔代收中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-29-4.
3.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringsingleCollection(StringjsonData);4.
3.
2请求报文数据元参数名称类型出现要求备注主账号pann…19C用户主账户号交易金额transAmountans…13M交易金额的币种均为人民币,单位为元,保留两位小数用户号码类型userNumTypeans2M参考《多渠道平台接入规范-第五部分》附录F用户号码userNumans…40M用户号码地区编码userNumAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C用户号码附加地区编码userNumAddAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C缴费月份payMonthans6CYYYYMM,当本域填写"000000"时,用于缴纳全部用户号码费用.
当且仅当附加子域中不存在费用索引值时,本域有效.
附加子域内容addnContentans…538O填写实际长度的附加子域内容.
若无内容,则本域不存在报文示例:{"payMonth":"000000","userNum":"18600010001","transAmount":"12","userNumAddAreaCode":"0000","userNumType":"01","userNumAreaCode":"7901","pan":"6225880000000000001"}4.
3.
3应答报文数据元参数名称类型备注POS终端号termIdans8MPOS终端代码中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-30-数据元参数名称类型备注POS商户号mchntIdans15MPOS商户代码响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息商户名称mchntNameans…20M商户名称操作员号operatorNon2M操作员编号收单行标识acqNoan11C发卡行标识issNoan11C收单行名称acqNameans…60C发卡行名称issNameans…60C交易流水号traceNoan6C检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号受卡方交易时间localTimen6Chhmmss受卡方交易日期localDaten4CMMDD主帐号cardNon…19C银行卡号交易类型transTypeansC用户号码userNumans…40C系统受理时间sysAccDateans14M4.
4单笔代收撤销4.
4.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringcancelSingleCollection(StringjsonData);4.
4.
2请求报文数据元参数名称类型出现要求备注主账号pann…19C银行卡主帐号原交易系统跟踪号oriTraceNon6M参考《多渠道平台接入规范-第五部分》附录F原交易检索号oriRetrvlRefNoan12M中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-31-4.
4.
3应答报文数据元参数名称类型备注POS终端号termIdans8MPOS终端代码POS商户号mchntIdans15MPOS商户代码响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息商户名称mchntNameans…20M商户名称操作员号operatorNon2M操作员编号收单行标识acqNoan11C发卡行标识issNoan11C收单行名称acqNameans…60C发卡行名称issNameans…60C交易流水号traceNoan6C检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号受卡方交易时间localTimen6Chhmmss受卡方交易日期localDaten4CMMDD主帐号cardNon…19C银行卡号交易类型transTypeansC用户号码userNumans…40C冲正原因码revReasonCodean2C当应答码为"RV"时存在系统受理时间sysAccDateans14M4.
5实时代付4.
5.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringpayForAnother(StringjsonData);4.
5.
2请求报文数据元参数名称类型出现要求备注主帐号pann…19C银行卡主帐号中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-32-数据元参数名称类型出现要求备注交易金额transAmountans…13M交易金额的币种均为人民币,保留两位小数用户号码类型userNumTypeans2M参考《多渠道平台接入规范-第五部分》附录F用户号码userNumans…40M用户号码地区编码userNumAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C用户号码附加地区编码userNumAddAreaCodeans…4M参考《多渠道平台接入规范-第五部分》附录C缴费月份payMonthans6CYYYYMM,当本子域填写"000000"时,用于缴纳全部用户号码费用.
当且仅当附加子域中不存在费用索引值时,本域有效.
支付区间payRangeans17M"yyyymmdd-yyyymmdd",表示支付区间的起止日期.
对年月日中的"日"dd字段,若无具体日期要求,默认填写01和当月结束日期(根据月份选择28、29、30或31).
在代付业务代表支付区间附加子域内容addnContentans…3O填写实际长度的附加子域内容.
若无内容,则本域不存在安全信息输入方式safetyInfoEntryModeans…538M00:不输入校验信息01:输入持卡人身份证号02:输入持卡人名字03:输入持卡人身份证号&名字持卡人身份证号cardHolderIDN(6)C身份证号最后6位数字,遇最后一位是字母的,选择字母前6位数字.
持卡人名字cardHolderNameans…147C交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-33-数据元参数名称类型出现要求备注应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现4.
5.
3应答报文数据元参数名称类型出现要求备注POS终端号termIdans8MPOS终端代码POS商户号mchntIdans15MPOS商户代码响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息商户名称mchntNameans…20M商户名称操作员号operatorNon2M操作员编号收单行标识acqNoan11C发卡行标识issNoan11C收单行名称acqNameans…60C发卡行名称issNameans…60C交易流水号traceNoan6C检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号受卡方交易时间localTimen6Chhmmss受卡方交易日期localDaten4CMMDD主帐号cardNon…19C银行卡号交易类型transTypeansC用户号码userNumans…40C系统受理时间sysAccDaten14M批次号batchNon6C持卡人身份证号cardHolderIDans…20C持卡人名字cardHolderNameans…147C中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-34-4.
6代付确认4.
6.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringpayConfirm(StringjsonData);4.
6.
2请求报文数据元参数名称类型出现要求备注主帐号pann…19C银行卡主帐号交易金额transAmountAns…13M交易金额的币种均为人民币,保留两位小数原交易系统跟踪号oriTraceNon6M原交易日期oriTransDaten4MMMDD4.
6.
3应答报文数据元参数名称类型出现要求备注POS终端号termIdans8MPOS终端代码POS商户号mchntIdans15MPOS商户代码响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息商户名称mchntNameans…20M商户名称操作员号operatorNon2M操作员编号收单行标识acqNoan11C发卡行标识issNoan11C收单行名称acqNameans…60C发卡行名称issNameans…60C交易流水号traceNoan6C检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号受卡方交易时间localTimen6Chhmmss受卡方交易日期localDaten4CMMDD主帐号cardNon…19C银行卡号交易类型transTypeansC中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-35-数据元参数名称类型出现要求备注用户号码userNumans…40C系统受理时间sysAccDaten14M4.
7结算统计4.
7.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringdealStatistics(StringjsonData);4.
7.
2请求报文数据元参数名称类型请求备注请求标识funIdStringM1:查询当日代付交易明细;2:查询当日总计信息4.
7.
3应答报文funId=1(查询当日代付交易明细),应答报文如下:数据元参数名称属性出现要求备注响应码rspCodeans3M00:成功;01:失败响应描述responseTextans…20M处理编号funIdN1M商户号mchntIdN15M终端号mchntIdN8M处理时间dateTimeN14Myyyymmddhhmmss代付明细payListAns.
.
600MJSON格式每条代付明细格式:数据元参数名称属性出现要求备注响应码rspCodeans3M00:成功;01:失败卡号panans…20M中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-36-数据元参数名称属性出现要求备注金额amountN1M金额的币种均为人民币,单位为元,保留两位小数,例如:12.
34商户号mchntIdN15M终端号termIdN8M交易时间tsmDateTimeN8Mmmddhhmmss受理方机构码acqInsCodeAns.
.
12C交易凭证号voucherN6M检索参考号retrvlRefNoN12funId=2(查询总计信息),应答报文如下:数据元参数名称属性出现要求备注响应码rspCodeans3M00:成功;01:失败响应描述responseTextans…20M处理编号funIdN1M商户号mchntIdN15M终端号termIdN8M处理时间dateTimeN14Myyyymmddhhmmss代付总笔数payTotalSumN1.
.
6M代付总金额payTotalAmountN12M充值总笔数consumeTotalSumN1.
.
6M充值总金额consumeTotalAmountN12M4.
8手机充值4.
8.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringphoneRecharge(StringjsonData);中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-37-4.
8.
2请求报文数据元参数名称类型出现要求备注交易金额transAmountans…13M交易金额的币种均为人民币,保留两位小数第二磁道数据track2Dataans…37C充值借记卡第二磁道数据第三磁道数据track3Dataans…104C充值借记卡第三磁道数据手机号码userNumN11M待充值手机号码4.
8.
3应答报文数据元参数名称类型出现要求备注交易流水号traceNon6C本地交易时间localTimen6Chhmmss本地交易日期localDaten4CMMDD交易金额transAmountans…13C交易金额的币种均为人民币,保留两位小数检索参考号retrvlRefNoan12C时间(HHMMSS)+多渠道平台流水号(6位)响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6C受卡机终端标识码termIdans8M终端代码受卡方标识码mchntIdans15M商户代码主帐号cardNon…19C银行卡号商户名称mchntNameans…20M商户名称交易类型transTypeAnsC用户号码userNumans…40C系统受理时间sysAccDaten14M冲正原因码revReasonCodean2C当应答码为"RV"时存在中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-38-4.
9转账4.
9.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:Stringtransfer(StringjsonData);4.
9.
2请求报文数据元参数名称类型出现要求备注交易金额transAmountans…13M交易金额的币种均为人民币,保留两位小数第二磁道数据track2Dataans…35C(转出卡)磁条卡第二磁道数据第三磁道数据track3Dataans…104C磁条卡第三磁道数据转入卡卡号revPann…19M卡卡转帐交易时,填写转入卡卡号签购单自定义标题title4BillC第三方应用签购单自定义标题.
如果上送此域,则签购单打印的标题为此值;否则则使用默认值交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现4.
9.
3应答报文数据元参数名称类型出现需求备注交易流水号traceNon6C本地交易时间localTimen6Chhmmss本地交易日期localDaten4CMMDD中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-39-数据元参数名称类型出现需求备注交易金额transAmountans…13C交易金额的币种均为人民币,保留两位小数检索参考号retrvlRefNoan12C交易发起方系统给予交易的系统检索参考号响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6C转出卡号transCardNon…19C转出银行卡卡号转入卡号revPann…19C转入银行卡卡号转入卡持卡人姓名revNameans…147C填写转入卡持卡人姓名受卡机终端标识码termIdans8M终端代码受卡方标识码mchntIdans15M商户代码商户名称mchntNameans…60M商户名称系统受理时间sysAccDaten14M4.
10账单查询4.
10.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringbillQuery(StringjsonData);4.
10.
2请求报文数据元参数名称类型出现需求备注公共支付特有信息billInfoans…600M3个字节的长度值+最大600个字节(字母、数字和特殊字符)的公共支付业务特有信息;持卡人身份信息cardHolderInfoans.
.
200C信用卡账单查询业务时必选,采用61域用法五中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-40-4.
10.
3应答报文数据元参数名称类型出现需求备注交易流水号traceNon6M本地交易时间localTimen6Mhhmmss本地交易日期localDaten4MMMDD实际金额billAmountans…13C账单费用,如果此域为空,那么账单费用在公告支付特有信息中.
金额保留两位小数检索参考号retrvlRefNoan12M时间(HHMMSS)+多渠道平台流水号(6位)响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6C受卡机终端标识码termIdans8M终端代码受卡方标识码mchntIdans15M商户代码商户名称mchntNameans…20M商户名称交易类型transTypeans2.
.
4C公共支付特有信息billInfoans…600M3个字节的长度值+最大600个字节(字母、数字和特殊字符)的公共支付业务特有信息;系统受理时间sysAccDaten14M4.
11水电煤缴费4.
11.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringbillPayment(StringjsonData);4.
11.
2请求报文数据元参数名称类型出现需求备注中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-41-数据元参数名称类型出现需求备注主帐号pann…19C银行卡主帐号交易金额transAmountans…13M交易金额的币种均为人民币,保留两位小数,如12.
34元.
第二磁道数据track2Dataans…37C磁条卡第二磁道数据第三磁道数据track3Dataans…104C磁条卡第三磁道数据公共支付特有信息billInfoans…600M3个字节的长度值+最大600个字节(字母、数字和特殊字符)的公共支付业务特有信息;用户交易类型userTransTypeans2.
.
4M附录3.
2定义4.
11.
3应答报文数据元参数名称类型出现需求备注交易流水号traceNon6C本地交易时间localTimen6Chhmmss本地交易日期localDaten4CMMDD交易金额transAmountans…13C交易金额的币种均为人民币,保留两位小数检索参考号retrvlRefNoan12C时间(HHMMSS)+多渠道平台流水号(6位)响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6C受卡机终端标识码termIdans8M终端代码受卡方标识码mchntIdans15M商户代码主帐号cardNon…19C银行卡号商户名称mchntNameans…20M商户名称公共支付特有信息billInfoans…600M多渠道48域数据明细查询数据dtlInqans…600M多渠道59域数据,解析方式同48域数据中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-42-系统受理时间sysAccDaten14M冲正原因码revReasonCodean2C当应答码为"RV"时存在IC卡信息icCardInfoCIC卡交易存在4.
12社保缴费4.
12.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringtipsLevyAgent(Stringdata);4.
12.
2请求数据域名变量名属性出现要求备注交易金额transAmountn12M以分为单位,不足前补0征收机关代码taxOrgCdans12M纳税人、参保人所属的征收机关编码外部申报电子序号extLevyNoans20M纳税人、缴费单位通过其他途径进行申报时获得的电子流水号,由征收机关编制纳税人编码taxPayerCdans20M唯一标识纳税人信息的编码用户号码地区编码usrNoRegionCdans20M用户号码附加地区编码usrNoRegionAddnCdans20C如为二级地区,填写该地区附加地区编码,其余情况填"0000"财税库银业务通常为"0000"申报附言addCommentansxC备注信息交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-43-域名变量名属性出现要求备注端号发起交易应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现4.
12.
3应答数据域名变量名属性出现要求备注交易流水号traceNon6C本地交易时间localTimen6Chhmmss本地交易日期localDaten4CMMDD交易金额transAmountans…13C交易金额的币种均为人民币,保留两位小数检索参考号retrvlRefNoan12C时间(HHMMSS)+多渠道平台流水号(6位)响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6C受卡机终端标识码posTermIdans8M终端代码受卡方标识码posMchntIdans15M商户代码主帐号cardNon…19C银行卡号商户名称mchntNameans…20M商户名称附言addCommentans60M缴费回执附言系统受理时间sysAccDaten14M4.
13账单费用查询4.
13.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringbillQueryServlet(Stringdata);4.
13.
2请求数据域名变量名属性出现要求备注中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-44-域名变量名属性出现要求备注48域field48ans…1024M48域信息,组装方法见附录7.
6交易模式transModen2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNon15C交易模式=02时出现应用终端编号appTermNon8C交易模式=02时出现应用IDAppIDappIDn45M第三方应用的唯一标识,由银联指定.
应用名称AppNameappNameans60M第三方应用名称,由第三方应用自行定义.
交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易类型transTypeans2.
.
4M取值:CPT001:贷款申请CPT002:富民卡用信校验CPT003:贷款试算CPT009:缴费人员信息查询CPT010:缴费人员档次查询CPT011:缴费明细查询4.
13.
3应答数据域名变量名属性出现要求备注响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息本地交易时间localTimen6Mhhmmss本地交易日期localDaten4MMMDD系统受理时间sysAccDaten14M系统受理时间受卡机终端标识码posTermIdans8M终端代码受卡方标识码posMchntIdans15M商户代码商户名称mchntNameans…20M商户名称交易流水号traceNon6M检索参考号retrvlRefNoan12M时间(HHMMSS)+多渠中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-45-域名变量名属性出现要求备注道平台流水号(6位)48域field48ans…1024M48域信息,组装方法见附录7.
654域field54ans…1024C富民卡用信校验出现,存放贷款金额59域field59ans…1024C缴费人员档次查询存在;缴费明细查询结果超过6条时存在;63域field63ans…1024C缴费明细查询结果超过13条时存在;交易类型transTypeans2.
.
4C4.
14缴费(有密)4.
14.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringbillPaymentServletWithPin(Stringdata);4.
14.
2请求数据域名变量名属性出现要求备注主帐号pann…19C贷款明细查询、富民卡用信查询、贷款账户信息查询,必填交易金额transAmountn12M贷款明细查询、富民卡用信查询、贷款账户信息查询填000000000001.
社保缴费填写缴费人员档次查询返回的59域中TAG:BV选中的某个缴费档次的缴费档次金额.
其他交易类型的交易金额的币种均为人民币,以分为单位,前补0,如12.
34元填000000001234.
服务点输入方式码posEntryModen3M参考22域填写规范,第三位为中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-46-域名变量名属性出现要求备注1交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现应用IDAppIDappIDn45M第三方应用的唯一标识,由银联指定.
应用名称AppNameappNameans60M第三方应用名称,由第三方应用自行定义.
第二磁道数据track2Dataans…37C磁条卡第二磁道数据第三磁道数据track3Dataans…104C磁条卡第三磁道数据IC卡数据域field55ans…255C当为IC卡交易时存在48域field48ans…1024M48域信息,组装方法见附录7.
6交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易类型transTypeans2.
.
4M取值:CPT004:贷款明细查询CPT005:富民卡用信查询CPT007:贷款账户信息查询CPT012:社保缴费CPT013:贷款还款4.
14.
3应答数据域名变量名属性出现要求备注交易流水号traceNon6M本地交易时间localTimen6Mhhmmss本地交易日期localDaten4MMMDD交易金额transAmountans…13M交易金额的币种均为人民币,保留两位小数检索参考号retrvlRefNoan12M时间(HHMMSS)+多渠道平台流水号(6位)响应码rspCodeans…4M交易响应码.
具体参考中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-47-域名变量名属性出现要求备注附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6M主帐号cardNon…19C银行卡号受卡机终端标识码posTermIdans8M终端代码受卡方标识码posMchntIdans15M商户代码商户名称mchntNameans…60M商户名称交易类型transTypeans2.
.
4CIC卡应答数据field55ans…255C系统受理时间sysAccDaten14M冲正原因码revReasonCodean2C当应答码为"RV"时存在48域field48ans…1024M48域信息,组装方法见附录7.
659域field59ans…1024C59域信息,组装方法见附录7.
7贷款账户信息查询结果超过7条时存在,贷款明细查询结果超过2条时存在4.
15缴费(无密)4.
15.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringbillPaymentServletWithoutPin(Stringdata);4.
15.
2请求数据域名变量名属性出现要求备注主帐号pann…19C贷款销账、富民卡用信记账必填交易金额transAmountans…13M贷款销账填写贷款试算返回的中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-48-域名变量名属性出现要求备注54域.
富民卡用信记账填写富民卡用信校验返回的54域.
其他交易类型的交易金额的币种均为人民币,以分为单位,前补0,如12.
34元填000000001234.
服务点输入方式码posEntryModen3M参考22域填写规范,第三位为2交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易应用商户编号appMchntNoN15C交易模式=02时出现应用终端编号appTermNoN8C交易模式=02时出现应用IDAppIDappIDn45M第三方应用的唯一标识,由银联指定.
应用名称AppNameappNameans60M第三方应用名称,由第三方应用自行定义.
第二磁道数据track2Dataans…37C磁条卡第二磁道数据第三磁道数据track3Dataans…104C磁条卡第三磁道数据IC卡数据域field55ans…255C当为IC卡交易时存在48域field48ans…1024M48域信息,组装方法见附录7.
6交易索引号transIndexCodeans.
.
45M填写规则:交易类型+交易时间(yyyyMMddHHmmssSSS).
交易类型transTypeans2.
.
4MCPT006:富民卡用信记账CPT008:贷款销账4.
15.
3应答数据域名变量名属性出现要求备注交易流水号traceNon6M本地交易时间localTimen6Mhhmmss本地交易日期localDaten4MMMDD中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-49-域名变量名属性出现要求备注交易金额transAmountans…13M交易金额的币种均为人民币,保留两位小数检索参考号retrvlRefNoan12M时间(HHMMSS)+多渠道平台流水号(6位)响应码rspCodeans…4M交易响应码.
具体参考附录响应描述responseTextans…20M响应码对应的简要描述信息交易授权码authNoan6M主帐号cardNon…19C银行卡号受卡机终端标识码posTermIdans8M终端代码受卡方标识码posMchntIdans15M商户代码商户名称mchntNameans…60M商户名称交易类型transTypeans2.
.
4CIC卡应答数据field55ans…255C系统受理时间sysAccDaten14M冲正原因码revReasonCodean2C当应答码为"RV"时存在48域field48ans…1024M48域信息,组装方法见附录7.
65UPOP交易接口规范5.
1代收类交易5.
1.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringtakeCollection(Stringdata);5.
1.
2请求数据序号域名变量名出现要求属性备注中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-50-01交易金额txnAmtMN12单位为分,1234代表12.
34元02帐号accNoMAN1.
.
60交易帐号03证件类型idTypeMN201:身份证02:军官证03:护照04:回乡证05:台胞证06:警官证07:士兵证99:其它证件04证件号码idNoMANS1.
.
20证件号码05持卡人姓名cardHolderMANS1.
.
32支持汉字06手机号mobileNumCN1.
.
2007短信验证码smsCodeCN608持卡人密码pinCAN1.
.
3209卡片CVN2cvn2CN310卡有效期expDateON4YYMM5.
1.
3应答数据序号域名变量名出现要求属性备注01POS商户编号posMchntNoMN1502POS终端编号posTermNoMN803应答码respCodeMan204应答信息respMsgMans.
.
2005交易类型txnTypeMN211:代收12:代付31:消费撤销75:交易状态查询76:文件传输06商户代码merIdMN15已被批转加入银联互联网系统的商户代码,区别于收单商户代码.
07商户订单号orderIdMAN12.
.
32商户订单号,不能含"-"或"_"08订单发送时间txnTimeMYYYYMMDDhhmmss订单发送时间09交易传输时间traceTimeMYYYYMMDDhhmmss交易传输时间10交易金额txnAmtMN12单位为分,1234代表12.
34元中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-51-11帐号accNoMAN1.
.
60交易帐号12查询流水号queryIdMAN21由银联返回,用于在后续类交易中唯一标识一笔交易13系统跟踪号traceNoMAN215.
2代付类交易5.
2.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringtakePayment(Stringdata);5.
2.
2请求数据序号域名变量名出现要求属性备注01交易金额txnAmtMN12单位为分,1234代表12.
34元02帐号accNoMAN1.
.
60交易帐号03证件类型idTypeMN201:身份证02:军官证03:护照04:回乡证05:台胞证06:警官证07:士兵证99:其它证件04证件号码idNoMANS1.
.
20完整身份证号.
如果最后一位是X,输入包含X.
05持卡人姓名cardHolderMANS1.
.
32支持汉字08持卡人密码pinCAN1.
.
3209卡片CVN2cvn2CN310卡有效期expDateON4YYMM11业务模式modeMN201:第三方发起代付;02:资金归集;12消费交易流水号csmTraceNoCN6仅在资金归集业务时填写,关联消费交易的交易流水号;13消费交易批次号csmBatchNoCN6仅在资金归集业务时填写,关联消费交易的批次号;14交易模式transModeN2M01:从终端商户号、终端号发起交易02:从应用商户号、终端号发起交易中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-52-15应用商户编号appMchntNoN15C交易模式=02时出现16应用终端编号appTermNoN8C交易模式=02时出现5.
2.
3应答数据序号域名变量名出现要求属性备注01POS商户编号posMchntNoMN1502POS终端编号posTermNoMN803应答码respCodeMan204应答信息respMsgMans.
.
2005交易类型txnTypeMN211:代收12:代付31:消费撤销75:交易状态查询76:文件传输06收单机构代码acqInsCodeMAN11已被批准加入银联互联网系统的收单机构代码07商户代码merIdMN15已被批转加入银联互联网系统的商户代码,区别于收单商户代码.
08商户订单号orderIdMAN12.
.
32商户订单号,不能含"-"或"_"09订单发送时间txnTimeMYYYYMMDDhhmmss订单发送时间10交易传输时间traceTimeMYYYYMMDDhhmmss交易传输时间11交易金额txnAmtMN12单位为分,1234代表12.
34元12帐号accNoMAN1.
.
60交易帐号13查询流水号queryIdMAN21由银联返回,用于在后续类交易中唯一标识一笔交易14系统跟踪号traceNoMAN215.
3交易撤销类交易5.
3.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-53-接口方法:StringcancelTransaction(Stringdata);5.
3.
2请求数据序号域名变量名出现要求属性备注01原始交易流水号origQryIdMN12原始消费交易的queryId5.
3.
3应答数据序号域名变量名出现要求属性备注01POS商户编号posMchntNoMN1502POS终端编号posTermNoMN803应答码respCodeMan204应答信息respMsgMans.
.
2005交易类型txnTypeMN211:代收12:代付31:消费撤销75:交易状态查询76:文件传输06商户代码merIdMN15已被批转加入银联互联网系统的商户代码,区别于收单商户代码.
07商户订单号orderIdMAN12.
.
32商户订单号,不能含"-"或"_"08订单发送时间txnTimeMYYYYMMDDhhmmss订单发送时间09交易传输时间traceTimeMYYYYMMDDhhmmss交易传输时间10交易金额txnAmtMN12单位为分,1234代表12.
34元11帐号accNoMAN1.
.
60交易帐号12查询流水号queryIdMAN21由银联返回,用于在后续类交易中唯一标识一笔交易13系统跟踪号traceNoMAN215.
4交易状态查询类交易5.
4.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringqueryTransaction(Stringdata);中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-54-5.
4.
2请求数据序号域名变量名出现要求属性备注01商户订单号orderIdMAN12.
.
32被查询交易的订单号02原始交易流水号origQryIdCAN21当查询消费撤销、退货、预授权撤销、预授权完成、预授权完成撤销交易信息时,需填写原交易的QueryId.
如消费撤销时,需填写消费交易的QueryId.
5.
4.
3应答数据序号域名变量名出现要求属性备注01POS商户编号posMchntNoMN1502POS终端编号posTermNoMN803应答码respCodeMan204应答信息respMsgMans.
.
2005交易类型txnTypeMN211:代收12:代付31:消费撤销75:交易状态查询76:文件传输06商户代码merIdMN15已被批转加入银联互联网系统的商户代码,区别于收单商户代码.
07商户订单号orderIdMAN12.
.
32被查询交易的订单号08订单发送时间txnTimeMYYYYMMDDhhmmss被查询交易的交易时间09交易传输时间traceTimeMYYYYMMDDhhmmss交易传输时间10原始交易流水号origQryIdRAN2111查询流水号queryIdMAN21由银联返回,用于在后续类交易中唯一标识一笔交易12系统跟踪号traceNoMAN2113原交易应答码origRespCodeMan2原交易应答码为"00"表示被查询交易成功.
14原交易应答信息origRespMsgMans.
.
20中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-55-5.
5文件传输类交易5.
5.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringtransactByFile(Stringdata)5.
5.
2请求数据序号域名变量名出现要求属性备注01商户代码merIdMN15已被批转加入银联互联网系统的商户代码,区别于收单商户代码.
02清算日期settleDateMMMDD5.
5.
3应答数据序号域名变量名出现要求属性备注01POS商户编号posMchntNoMN1502POS终端编号posTermNoMN803应答码respCodeMan204应答信息respMsgMans.
.
2005交易类型txnTypeMN211:代收12:代付31:消费撤销75:交易状态查询76:文件传输06商户代码merIdMN15已被批转加入银联互联网系统的商户代码,区别于收单商户代码.
07订单发送时间txnTimeMYYYYMMDDhhmmss被查询交易的交易时间08清算日期settleDateMMMDD09文件类型fileTypeMN210文件名fileNameMANS1.
.
6411文件内容fileContentM压缩,Base64编码后的文件内容5.
6交易取消控制交易此交易典型使用场景为理财应用,在支付应用消费成功,UPOP代付成功后,该笔交易完中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-56-成,不能撤销,第三方应用发起交易取消控制交易,通知UPOP,该笔交易已完成不能取消.
5.
6.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringcancelControl(Stringdata);5.
6.
2请求数据序号域名变量名出现要求属性备注01原交易凭证号traceNoMN602原交易批次号batchNoMN65.
6.
3应答数据序号域名变量名出现要求属性备注6其它接口6.
1限额查询6.
1.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringlimitQuery();6.
1.
2请求报文无6.
1.
3应答报文数据元参数名称类型备注响应码rspCodeString交易响应码.
具体参考附录响应描述responseTextString响应码对应的简要描述信息终端单笔限额singleTermLimitString金额的币种均为人民币,单位为元,保留两位小数终端单日限额dayTermLimitString金额的币种均为人民币,单位为元,保留两位小数中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-57-6.
2限额设置6.
2.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringlimitSet(StringjsonData);6.
2.
2请求报文数据元参数名称类型备注终端单笔限额singleTermLimitString金额的币种均为人民币,单位为元,保留两位小数终端单日限额dayTermLimitString金额的币种均为人民币,单位为元,保留两位小数6.
2.
3应答报文数据元参数名称类型备注响应码rspCodeString交易响应码.
具体参考附录响应描述responseTextString响应码对应的简要描述信息终端单笔限额singleTermLimitString金额的币种均为人民币,单位为元,保留两位小数终端单日限额dayTermLimitString金额的币种均为人民币,单位为元,保留两位小数6.
3当日剩余额度查询6.
3.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringlimitLeft();6.
3.
2请求报文无6.
3.
3应答报文中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-58-数据元参数名称类型备注响应码rspCodeString交易响应码.
具体参考附录响应描述responseTextString响应码对应的简要描述信息终端当日剩余额度termLimitLeftString金额的币种均为人民币,单位为元,保留两位小数6.
4终端信息查询接口6.
4.
1调用接口接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringgetPOSInfo(StringjsonData)6.
4.
2请求参数String类型,JSON数据格式,具体规范如下:字段名变量名出现要求类型(长度)说明应用IDAppIDMN第三方应用的唯一标识,由银联指定.
应用名称AppNameMAN或中文第三方应用名称,由第三方应用自行定义.
交易请求日期ReqTransDateMYYMMDD(6)第三方发起请求的日期.
6.
4.
3返回参数字段名变量名出现要求类型(长度)说明商户号MerchantIDMN商户ID,唯一标志商户终端号TerminaIDMN终端ID,唯一标志终端操作员号OperatorIDMN操作员ID,唯一标志操作员返回码RespCodeMAS…6支付系统返回给第三方应用的应答码的对应中文解释,请参照本文4.
3章所述.
返回码中文解释RespDescM中文支付系统返回给第三方应用的应答码的对应中文解释,请参照本文4.
3章所述.
6.
5终端激活中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-59-6.
5.
1接口调用接口类型:AndroidIPC通信AIDL接口接口权限:com.
unionpay.
CloudPosPaymentClient.
permission.
CLOUDPAY接口方法:StringgetAppTerms();6.
5.
2请求报文无6.
5.
3应答报文数据元参数名称属性出现要求备注响应码rspCodeans3M00:成功;01:失败响应描述responseTextans…20M商户号posMchntIdN15M终端号posTermIdN8M系统受理时间sysAccDateans14M应用终端明细appTermListAns.
.
600MJSON格式应用终端明细每个应用终端明细数据元参数名称属性出现要求备注商户号appMchntIdN15M终端号appTermIdN8M应用名称appNameAns.
.
80M7附录7.
1调用方法介绍1、第三方收银应用持有银联支付客户端支付接口文件ICloudPay.
aidl2、在工程的源码目录下建立包"com.
unionpay.
CloudPosPaymentClient.
aidl",包创建完毕后,拷贝ICloudPay.
aidl接口文件至这个包下.
2、Build工程,利用ADT生成ICloudPay.
aidl的Java接口文件.
中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-60-3、注册接口权限,在AndroidManifest.
xml文件中注册调用权限.
4、绑定到银联支付应用服务.
5、绑定支付服务成功后,调用银联支付接口.
中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-61-6、退出时和银联支付服务解除绑定.
7.
2参数解释注:这里的请求是指第三方收银应用向银联支付应用发送请求报文;应答是指银联支付应用向第三方收银应用发送响应报文.
第三方应用与支付之间的交换消息中,各数据元类型如下所列:——A字母.
——AN字母和/或数字——ANS字母、数字和/或特殊符号——AS字母和/或特殊符号——N数字——YY年中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-62-——MM月——DD日.
——hh时.
——mm分——ss秒注:可选的意思是有值返回,第三方可以根据需求选择是否获取,此类参数非必须参数.
字段符号说明:M不管该字段是否为空,它必须在记录中出现.
O可选字段C满足一定条件才会出现的字段7.
3用户交易类型定义交易类型编码交易类型说明JS水费缴费JD电力缴费JM燃气缴费GD广电缴费7.
4返回应答码表交易返回POS终端时都有应答码,可以把操作分为以下几类:A:交易成功B:交易失败,可重试C:交易失败,不需要重试D:交易失败,终端操作员处理E:交易失败,系统故障,不需要重试F:交易失败,支付客户端未处理-1:如果返回应答码不能在下表中找到,中文解释显示"交易失败"-2:如果POS交易的批次号和网络中心批次号不一致时应答码会填"77",此时POS机应当提示操作员重新签到,再作交易.
代码意义类别原因/采取的措施POS显示的内容00承兑或交易成功A承兑或交易成功交易成功01查发卡行C查发卡行请持卡人与发卡银行联系03无效商户C商户需要在银行或中心登记无效商户中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-63-代码意义类别原因/采取的措施POS显示的内容04没收卡D操作员没收卡此卡被没收05身份认证失败C发卡不予承兑,预约信息匹配失败持卡人认证失败10部分承兑A部分金额批准,请收取余额显示部分批准金额,提示操作员11重要人物批准(VIP)A此为VIP客户成功,VIP客户12无效的关联交易C发卡行不支持的交易无效交易13无效金额B金额为0或其他非法值无效金额14无效卡号(无此账号)B卡种未在中心登记或读卡号有误无效卡号15无此发卡方C此发卡行未与中心开通业务此卡无对应发卡方21卡未初始化C1、该卡未激活、开卡;2、该卡初始密码未变更;3、初始密码限制的交易;4、长期未使用而冻结或状态为"睡眠"的卡.
该卡未初始化或睡眠卡22故障怀疑,关联交易错误CPOS状态与中心不符,可重新签到操作有误,或超出交易允许天数25找不到原始交易C发卡行未能找到有关记录没有原始交易,请联系发卡方30报文格式错误C格式错误(不符合磁道预校验规则)请重试34有作弊嫌疑D有作弊嫌疑的卡,操作员可以没收作弊卡,呑卡38超过允许的PIN试输入D密码错次数超限,操作员可以没收密码错误次数超限,请与发卡方联系40请求的功能尚不支持C发卡行不支持的交易类型发卡方不支持的交易类型41挂失卡D挂失的卡,操作员可以没收挂失卡,请没收(POS)43被窃卡D被窃卡,操作员可以没收被窃卡,请没收51资金不足C账户内余额不足可用余额不足54过期的卡C过期的卡该卡已过期55不正确的PINC密码输错密码错57不允许持卡人进行的交易C不允许持卡人进行的交易不允许此卡交易58不允许终端进行的交易C该商户不允许进行的交易发卡方不允许该卡在本终端进行此交易59有作弊嫌疑CCVN验证失败卡片校验错61超出金额限制C一次交易的金额太大交易金额超限62受限制的卡C受限制的卡中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-64-代码意义类别原因/采取的措施POS显示的内容64原始金额错误C原始金额不正确交易金额与原交易不匹配65超出消费次数限制C超出消费次数限制超出消费次数限制68发卡行响应超时C发卡行规定时间内没有回答交易超时,请重试75允许的输入PIN次数超限C允许的输入PIN次数超限密码错误次数超限90正在日终处理C日期切换正在处理系统日切,请稍后重试91发卡方不能操作C电话查询发卡方或银联,可重作发卡方状态不正常,请稍后重试92金融机构或中间网络设施找不到或无法达到C电话查询发卡方或网络中心,可重作发卡方线路异常,请稍后重试94重复交易C查询网络中心,可能是一笔已经成功上送的交易拒绝,重复交易,请稍后重试96银联处理中心系统异常、失效C发卡方或网络中心出现故障拒绝,交换中心异常,请稍后重试97POS终端号找不到D终端未在中心或银行登记终端未登记98银联处理中心收不到发卡方应答E银联收不到发卡行应答发卡方超时99PIN格式错B可重新签到作交易PIN格式错,请重新签到A0MAC鉴别失败B可重新签到作交易MAC校验错,请重新签到A1转账货币不一致C转账货币不一致转账货币不一致A2有缺陷的成功A银联处理中心转发了原充值交易请求,但未收到发卡方应答时,银联处理中心直接向受理方应答为有缺陷的成功交易交易成功,请向发卡行确认A3资金到账行无此账户C资金到账行账号不正确账户不正确A4有缺陷的成功A未收到原充值交易请求时,对关联的确认交易的承兑为有缺陷的成功交易交易成功,请向发卡行确认A5有缺陷的成功A原充值交易为拒绝时,对关联的确认交易的承兑为有缺陷的成功交易交易成功,请向发卡行确认中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-65-代码意义类别原因/采取的措施POS显示的内容A6有缺陷的成功A银联处理中心转发了原充值交易请求,但未收到发卡方应答时,对受理方发来的关联的确认交易的承兑为有缺陷的成功交易交易成功,请向发卡行确认A7安全处理失败C1、调用MAC校验程序失败2、调用PIN校验程序失败3、MAC处理失败4、密钥处理失败拒绝,交换中心异常,请稍后重试100上一笔交易未完成F等待上一笔交易完成后重试上一笔交易未完成101请求报文数据格式错误F重新组装正确的报文请求报文数据格式错误102支付调用取消F第三方应用收到支付响应报文之前,支付界面关闭支付调用取消103支付应用未启动或未登录F启动支付客户端登陆后重试支付应用未启动或未登录104未找到交易类型F支付后台不支持的交易类型未找到交易类型105未知错误,交易失败F未知原因引起的错误未知错误,交易失败RS冲正成功B交易超时无应答,冲正成功冲正成功RF冲正失败B交易超时无应答,冲正无应答冲正失败7.
5AIDL文件7.
648域自定义域7.
6.
1格式说明1、标准化业务适用的交易包括:账单费用查询、缴费(有密)、缴费(无密).
位置长度格式内容说明02ans用法标志"ZZ"2x1ansTlv12+x1x2ansTlv2……………中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-66-yxnansTlvny+xn1ans结束标志"#".
TLV不存在时,紧接前面用法标志填写本域将根据不同的交易、不同的业务包含不同的子域,为适应该子域需要不断变化的情况,采用TLV(tag-length-value)的表示方式,即每个子域由tag标签(T),子域取值长度(L)和子域取值(V)构成.
tag标签(T)的属性为ASCII,固定占2个字节长度.
子域取值长度(L)的属性为ASCII,固定占3个字节长度.
子域取值(V)根据不同的子域含义分别取不同的数值.
表1必填信息子域子域中文名称子域tag标签值子域取值所占长度(单位:字节)子域属性请求应答业务模式AA1anM用户号码类型AB2anMC用户号码AC最大到40anMC用户号码地区编码AD4anMC用户号码附加地区编码AE4~10anMC第三方具体采用哪种业务模式,根据实际业务场景确定.
内蒙贷款场景:样例:请求报文[ZZAA0013AB002U2AC0166225160801234560AD0041900AE0040006AF006000000BD01115214330811BI003000BJ003060CC004CE0011CG0011AO20011111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111AN20011111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111AP0101111111111AM0101111111111#]应答报文中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-67-[]7.
759域明细查询数据7.
7.
1格式说明表2通用格式位置序号长度格式内容说明02ans用法标志取值为:BI210n费用索引YYYYMMnnnn(保留使用)12XAns…587明细信息最长58712+xans1结束标志"#"1、标准化业务适用的交易包括:账单费用查询、缴费(有密)、缴费(无密).
表3标准化业务明细信息格式位置长度格式内容说明12x1ansTlv112+x1x2ansTlv2……………yxnansTlvny+xn1ans结束标志"#".
TLV不存在时,紧接前面用法标志填写本域将根据不同的交易、不同的业务包含不同的子域,为适应该子域需要不断变化的情况,本域采用TLV(tag-length-value)的表示方式,即每个子域由tag标签(T),子域取值长度(L)和子域取值(V)构成.
tag标签(T)的属性为ASCII,固定占2个字节长度.
子域取值长度(L)的属性为ASCII,固定占3个字节长度.
子域取值(V)根据不同的子域含义分别取不同的数值.
第三方具体采用哪种业务模式,根据实际业务场景确定.
内蒙贷款场景:见7.
6章节.
样例:7.
863域自定义域7.
8.
1交易明细用法格式说明适用的交易包括:账单费用查询.
表4标准化业务明细信息格式中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-68-位置长度格式内容说明03n长度值3x1ansTlv13+x1x2ansTlv2……………yxnansTlvn本域将根据不同的交易、不同的业务包含不同的子域,为适应该子域需要不断变化的情况,采用TLV(tag-length-value)的表示方式,即每个子域由tag标签(T),子域取值长度(L)和子域取值(V)构成.
tag标签(T)的属性为ASCII,固定占2个字节长度.
子域取值长度(L)的属性为ASCII,固定占3个字节长度.
子域取值(V)根据不同的子域含义分别取不同的数值.
样例:7.
8.
2营销活动签购单备注栏信息格式说明7.
8.
2.
1仅自动折扣活动存在63.
2.
1="本次立减X元"63.
2.
3="实付Y元"其中X为折扣金额,Y为折扣后金额,X+Y=交易总金额7.
8.
2.
2仅优惠券(不改终端模式)存在63.
2.
1="本次优惠M元"63.
2.
3="实付N元"其中M为优惠金额,N为优惠后金额,M+N=交易总金额7.
8.
2.
3自动折扣+优惠券(不改终端模式)同时存在63.
2.
1="本次优惠M元"63.
2.
2="额外立减T元"63.
2.
3="实付N元"其中M为优惠金额,T为折扣金额,N为优惠及折扣后金额,T+M+N=交易总金额7.
962域自定义域3个字节的长度值+最大512个字节的数据域.
7.
9.
1持卡人增值服务信息标准用法格式说明本域用在银联钱包业务中存储持卡人增值服务信息,由TLV格式构造,域标签为FF9140,中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-69-域内容根据交易类型不同,子用法不同.
7.
9.
1.
1增值服务查询1、增值服务查询请求(子用法CX)TAG格式含义说明FFA044ans2用法标识CXFF9141an2业务处理码1A:优惠券2A:积分4A:电子票样例:2、增值服务查询应答(子用法CY)优惠券用法TAG格式含义说明FFA044ans2用法标识CYFF9141an2业务处理码1A:优惠券FFA077n12优惠总金额本笔交易可优惠的总金额,由钱包计算得到最优方案.
优惠总金额为人民币金额,不足12位时左补0,如无优惠项目,填写12位0.
FFA078n12仍需支付金额FFA079ans2增值服务详细应答码FFA07Aans.
.
30增值服务详细应答信息最多15个汉字FFA056n1明细记录数优惠券最多支持5条FFA057ans.
.
315增值服务明细信息见增值服务明细格式样例:7.
9.
1.
2增值服务消费1、增值服务消费请求(子用法CD)优惠券用法TAG格式含义说明FFA044ans2用法标识CDFF9141an2业务处理码1A:优惠券中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-70-TAG格式含义说明FFA077n12优惠总金额本笔交易可优惠的总金额,由钱包计算得到最优方案.
优惠总金额为人民币金额,不足12位时左补0,如无优惠项目,填写12位0.
FFA078n12仍需支付金额FFA056n1明细记录数优惠券最多支持5条FFA057ans.
.
315增值服务明细信息见增值服务明细格式样例:2、增值服务消费应答(子用法CE)TAG格式含义说明FFA044ans2用法标识CEFF9141an2业务处理码1A:优惠券2A:积分4A:电子票FFA07Bn12票券购买金额线上购买票券的支付总金额FFA078n12卡付金额线下银行卡支付的消费金额FFA077n12优惠总金额优惠券项目或积分项目抵扣的金额,电子票项目的票面金额FFA04Eans60打印内容签购单备注栏打印内容FFA079ans2增值服务详细应答码FFA07Aans.
.
30增值服务详细应答信息最多15个汉字FFA072ans.
.
200二维码信息样例:7.
9.
1.
3增值服务明细信息格式增值服务明细记录以LV(记录长度+记录内容)的格式保存,当有多条明细记录时,通过多条LV数据来保存.
记录内容采用TLV格式保存,具体记录包含的标签如下:TAG格式含义说明FFA045an2增值服务类型码FFA049ans20项目名称FFA048an15项目ID中国银联股份有限公司www.
chinaunionpay.
com中国银联电子支付研究院云支付终端第三方应用支付接口规范-71-TAG格式含义说明FFA076n9项目使用数量本次交易计划使用增值服务条数,无小数位,不足左补0.
电子票张数需显示在终端界面.