《中国银联福建分公司增值平台缴费项目终端接口v2[1]4.doc》由会员分享，可在线阅读，更多相关《中国银联福建分公司增值平台缴费项目终端接口v2[1]4.doc（35页珍藏版）》请在三一办公上搜索。
1、中国银联福建分公司增值平台缴费项目终端接口文档属性文档名称：中国银联福建分公司增值平台缴费项目终端接口项目名称：终端缴费项目（包括：联通、网通、移动、电讯等）版本号：2.4文档编号：撰写者：技术管理部 刘晓声日期：2004-01-12复核者：日期：负责者：日期：审批者：日期：版本历史：版本号修改内容撰写者发布日期V1.0刘晓声2004-01-12V1.1添加44，扩充该报文为所有终端缴费项目用肖新华刘晓声2004-3-24V1.2修改查询交易48域 周鑫2004-8-16V1.3增加、修改短信定制/短信取消定制，委托授权/委托消权交易周鑫2004-08-24V1.4缴费类交易（不含定制类）中，
2、除了欠费查询、缴费，48域都不用送。原因不详。陈霄峰2004/11/22V1.5增加定制冲正、定制撤销冲正交易陈霄峰2004/11/22V1.6为缴费撤消、充值撤消加52域陈霄峰2004/11/22V1.7定制类交易去掉60域，加上63域放批次号。此前，交易类型已经放到48域偏移81处了。陈霄峰2004/11/22V1.8所有52域都是可选域陈霄峰2004/11/22V1.9缴费类撤销响应金额恒为零，因为福州终端不保留流水，这是由于福州采用POS做终端，内存有限。注意，冲正是包含原交易金额的。陈霄峰2005/6/10V1.10缴费交易48域增加定制类型，因为既需要运营商，也需要知道通过什么服务
3、来缴费陈霄峰2005/8/2V1.11删掉充值类交易，因为功能与缴费类重叠缴费撤销没有#48；加大#48到512B陈霄峰2005/12/28V1.4增加联通手机支付交易汪治国2006/07/1V1.5增加建阳电费交易汪治国2006/08/23V2.1所有报文增加30域，该域只存在相应中，并是可选域汪治国2007/06/28V2.2查询、缴费、冲正交易增加31域，该域为可选域，用来上送用户号信息，解决34域无法存放字母和汉字的问题汪治国2007/09/21V2.3增加积分类交易（积分查询、积分兑换、积分兑换撤销和冲正）汪治国2007/10/10版权声明：此文档的版权归中国银联福建分公司所有，作为
4、本系统的最终用户，可以拥有该份文档的使用权，但未征得中国银联福建分公司的书面批准，不得向第三方借阅、出让、出版该文档。目 录1.文档介绍31.1文档目的31.2文档范围31.3读者对象31.4参考文献31.5术语与缩写解释31.6符号约定41.7数据类型41.8连接方式52 交易流程62.1 缴话费73交易报文93.1话费查询93.2充值交易错误！未定义书签。3.3缴费交易113.4缴费冲正交易123.5充值冲正交易错误！未定义书签。3.6缴费撤消交易123.7充值撤消交易错误！未定义书签。3.8缴费撤消冲正交易133.9充值撤消冲正交易错误！未定义书签。3.10 定制、委托授权/定制取消、委
5、托消权143.11 定制查询交易153.12定制、委托授权/定制取消、委托消权/定制查询补充说明（48域）163.13 终端签到174 加密算法201. 文档介绍1.1文档目的本文档将帮助系统设计人员、编程人员、测试人员了解基于中国银联福建分公司增值平台的报文接口，并以此文档为基准，进行下一步的通讯连接、用户界面、数据库的细化设计。1.2文档范围本文档描述了中国银联福建分公司增值平台：1.话费查询，2.充值交易，3. 缴费交易等交易报文接口。本文档不对引用的标准、术语进行具体解释，如需获得此方面的帮助，请自行查阅相关的参考文献。1.3读者对象系统设计人员、编程人员、测试人员1.4参考文献银行卡
6、联网联合技术规范1.5术语与缩写解释缩写、术语解 释增值平台中国银联福建分公司增值业务平台，简称AVP 入网机构与增值平台进行连接，并进行请求或响应交易的机构用户使用电缴费终端的用户商户使用缴费终端的商户1.6符号约定含义发送方SSwitch缩写，银联交换系统EEasylink Added Value Platform缩写，增值平台C自助终端含义M必须填写的域数据元数值符号C某条件成立时必须填写的域C+某条件成立时增加的域C-某条件成立时删除的域M+必须增加的域O受理方和发卡方自选填写的域转发域必须与先前消息中对应域的值相同的域00自定义数据元中须填充0的域必须去除的域1.7数据类型交换中心与
7、各入网机构的消息中，各数据元类型如下所示：数据类型定义a字母字符，向左靠，右边多余位填空格b数据的二进制表示n数字，右靠，首位有效数字前填零。若表示金额，则最右二位为角、分s特殊字符an字母和数字字符，左靠，右边多余位填空格as字母和特殊符号，左靠，右边多余位填空格ans字母、数字和特殊字符，左靠，右边多余位填空格MM月份YY年份DD日期hh时mm分ss秒LL后跟可变长域的长度值（二位数）LLL 后跟可变长域的长度值（三位数）VAR可变长度域对可变长数据元的说明：对任何最大长度小于100个字符的可变长度数据元，两个附加位位于该数据元之前，标明其后所跟数据元的长度。其格式表示为LLVAR。对任何
8、最大长度小于1000个字符的可变长度数据元，三个附加位位于该数据元之前，标明其后所跟数据元的长度。其格式表示为LLLVAR。x借贷符号，借记为“D”，贷记为“C”，且总是与一个数字型金额数据元相连z由ISO7811和ISO7813定义的磁卡第二和第三磁道的代码集1.8连接方式入网机构与增值平台采用TCP/IP Socket长连接。2 交易流程终端采用GPRS无线通讯方式。在终端上，要提供一个参数设置的接口，包括：商户号，终端号，通讯参数，路由参数（NII），主密钥和一套工作密钥（PIN KEY，MAC KEY）。终端主界面为：1：联通业务 2：终端签到3：结算2.1 缴话费在终端主界面上选择1
9、后，1：缴话费 选择1后请输入需要缴费的手机号码，按回车确认终端向增值平台发送话费查询的交易请求，等待应答失败，交易结束 成功缴费金额0缴费金额=0手机号码为13022273864的用户本月没有欠费，需要充值请选择充值金额1：50 2：100 3：150 4：200 5：250 6：取消手机号码为13022273864的用户本月要缴费的金额为：XX.XX请刷卡请输入银行卡密码终端向增值平台发送缴费交易，若成功，打印单据。失败则显示相应的出错信息。3交易报文3.1话费查询位数据元数据类型发送方及数值备注CEEC信息类型N4010001101位元表B64MM3处理码N6MM420xxx11交易流水
10、N6MM请求流水12交易时间N6MMHHMMSS13交易日期N4MMMMDD30终端打印数据Ans.250C当数据需要终端显示时会带上该域（以50个字节为划分单位，目前前50个字节为中奖信息）31电话号码Ans.250CC因为34域无法上送字母或汉字，如果用户号中出现这种情况，则使用该域。但34也必须还保留，可以送上空内容。注意：1、如果一个报文中31和34域都存在时，34域的信息将会被丢弃。2、31的请求和应答是成对出现的。34电话号码N.28MM对光大：前3个字节也是服务提供商ID号，便于光大知道是哪个行业的缴费号码37系统流水号An12M39应答码An2M41终端号Ans8MM42商户号
11、Ans15MM44附件响应数据Ans .3M服务提供商ID号48附件数据Ans.512M查询结果返回数据49币别代码an3MM15663附加数据Ans6M批次号64消息鉴别码B32C9C9注释：48域格式：序号偏移长度备注1120缴费ID号，不足右补空格2211正号或负号，分别表示余额和欠费 32212缴费金额，不足左补0 ，以分为单位43420用户名称34域：联通缴费，必须在34域-手机号码前补1位0（即44域为004）44域：001 电信002 网通003 移动004 联通998西岸（短信）015电费（光大银行）016红十字捐款（光大银行）018 交警罚没款020联通手机支付绑定类交易（绑
12、定类交易）030移动手机支付绑定类交易（绑定类交易）040电信手机支付绑定类交易（绑定类交易）053 泉州广电缴费028 建阳电力缴费交易024 广电委托批扣025 联通委托批扣 026 移动委托批扣027 电信委托批扣041 福州地税自助缴税042 福州水费044 福州煤气047 希望工程048 儿童基金捐款054 泉州广电行业缴费（绑定）057 残疾人 058 福建太平洋保险059 电信固网支付（缴费）060 电信固网支付（消费）d01 光大闽运d02 光大物业a99 光大财务通（01-1中类型）a01 泉州商业银行（生意通）a02 福州商业银行（生意通）a03 邮储生意通（生意通）a04
13、 福州民生银行（生意通）a05 兴业银行泉州分行（生意通）a06 交通银行（福州市生意通）a07 交通银行（泉州市生意通）a08 光大银行（生意通）a09 中信银行（生意通）a10 工行泉州（生意通）a11 泉州民生（生意通）a12 农信社（生意通）以下参数待定：061 邮政储汇（三通交易）062 工商银行（三通交易）063 农业银行（三通交易）064 中国银行（三通交易）065 建设银行（三通交易）066 交通银行（三通交易）067 中信银行（三通交易）068 光大银行（三通交易），不用分配新机构直接使用现有的（80153900）069 华夏银行（三通交易）070 民生银行（三通交易）071
14、 招商银行（三通交易）072 兴业银行（三通交易）073 福商银行（三通交易）074 泉商银行（三通交易）075 农信银行（三通交易）48域（查询返回的，和终端开发无关，只是备注）：B01 qz市区宽带业务费B02 qz市区数字费B03 qz市区建设费B04 qz市区其他费001 电信591 电信福州592 电信厦门593 电信宁德594 电信莆田595 电信泉州596 电信漳州597 电信龙岩598 电信三明599 电信南平SFZ 移动福州（手机）SLY 移动龙岩（手机）SND 移动宁德（手机）SNP 移动南平（手机）SPT 移动莆田（手机）SQZ 移动泉州（手机）SSM 移动三明（手机）S
15、ZZ 移动漳州（手机）FZ 联通福州分公司PT 联通莆田分公司SM 联通三明分公司QZ 联通泉州分公司ZZ 联通漳州分公司NP 联通南平分公司LY 联通龙岩分公司ND 联通宁德分公司004 联通a01 泉州商业银行（生意通）a02 福州商业银行（生意通）a03 邮储生意通（生意通）a04 福州民生银行（生意通）a05 兴业银行泉州分行（生意通）a06 交通银行（福州市生意通）a07 交通银行（泉州市生意通）abg 邮储生意通(龙岩市)aae 邮储生意通(晋江市)aak 邮储生意通(漳州市)abo 邮储生意通(福鼎市)aa2 邮储生意通(闽侯县)aa3 邮储生意通(连江县)aa4 邮储生意通(罗
16、源县)aa5 邮储生意通(闽清县)aa6 邮储生意通(永泰县)aa7 邮储生意通(长乐市)aa8 邮储生意通(福清市)aa9 邮储生意通(平潭县)aaa 邮储生意通(莆田市)aab 邮储生意通(仙游县)aad 邮储生意通(惠安县)aaf 邮储生意通(南安市)aag 邮储生意通(安溪县)aah 邮储生意通(永春县)aai 邮储生意通(德化县)aaj 邮储生意通(石狮市)aal 邮储生意通(龙海市)aam 邮储生意通(云霄县)aan 邮储生意通(漳浦县)aao 邮储生意通(诏安县)aap 邮储生意通(长泰县)aaq 邮储生意通(东山县)aar 邮储生意通(南靖县)aas 邮储生意通(平和县)aat
17、 邮储生意通(华安县)aau 邮储生意通(三明市)aav 邮储生意通(明溪县)aaw 邮储生意通(清流县)aax 邮储生意通(宁化县)aay 邮储生意通(大田县)aaz 邮储生意通(尤溪县)ab1 邮储生意通(沙县) ab2 邮储生意通(将乐县)ab3 邮储生意通(泰宁县)ab4 邮储生意通(建宁县)ab5 邮储生意通(永安市)ab6 邮储生意通(南平市)ab7 邮储生意通(邵武市)ab8 邮储生意通(顺昌县)ab9 邮储生意通(建阳市)aba 邮储生意通(建瓯市)abb 邮储生意通(浦城县)abc 邮储生意通(武夷山市)abd 邮储生意通(光泽县)abe 邮储生意通(松溪县)abf 邮储生意
18、通(政和县)abh 邮储生意通(长汀县)abi 邮储生意通(永定县)abj 邮储生意通(上杭县)abk 邮储生意通(武平县)abl 邮储生意通(漳平市)abm 邮储生意通(连城县)abn 邮储生意通(宁德市)abp 邮储生意通(霞浦县)abq 邮储生意通(福安市)abr 邮储生意通(古田县)abs 邮储生意通(屏南县)abt 邮储生意通(寿宁县)abu 邮储生意通(周宁县)abv 邮储生意通(柘荣县)aa1 邮储生意通(福州市)aac 邮储生意通(泉州市)003 移动YSM 三明移动分公司YLY 龙岩移动分公司YFZ 福州移动分公司YXM 厦门移动分公司YPT 莆田移动分公司YND 宁德移动分
19、公司YQZ 泉州移动分公司YZZ 漳州移动分公司YNP 南平移动分公司T02 鼓楼地税局T03 台江地税局T04 仓山地税局T11 晋安地税局T21 闽侯地税局T22 连江地税局T23 罗源地税局T25 永泰地税局T28 平潭地税局T81 福清地税局T82 长乐地税局T90 直属分局T91 外税分局T05 马尾地税局T24 闽清地税局T55 琅岐地税局D01 建阳电力MFZ 福州移动分公司MPT 莆田移动分公司MSM 三明移动分公司MQZ 泉州移动分公司MZZ 漳州移动分公司MNP 南平移动分公司MLY 龙岩移动分公司MND 宁德移动分公司MXM 厦门移动分公司X01 融侨（江南水都名筑）X0
20、2 融侨（江南水都杰座）X03 融侨（江南水都杰座西区）X04 融侨（融侨锦江B区）X05 融侨（融侨锦江C区）X06 融侨（融侨锦江D区）X07 南国金辉X08 水印长天J01 希望工程（指定性捐款）J02 儿童基金（春蕾助学）J03 儿童基金（救助资金）J04 残联J05 希望工程（一般性捐款）GH1 光大红十字GD1 光大电力002 网通998 西岸网讯da1 光大闽运db1 光大物业(融侨)db2 光大物业(宝龙)dc1 光大财务通(一中)I10 中国人寿（集团）I11 中国人寿（股份）关于光大银行的电费请参考福州光大与银联增值平台接口补充说明的终端部分关于移动的请参考银联缴费返回域的
21、补充说明(移动终端)3.2缴费交易位数据元数据类型发送方及数值备注CEEC信息类型N4020002101位元表B64MM2卡号N.19M3处理码N6MM430xxx4交易金额N12MM充值金额，右对齐，左补零，不带小数点11交易流水N6MM12交易时间N6MMHHMMSS13交易日期N4MMMMDD22POS输入方式N3M30终端打印数据Ans.250C当数据需要终端显示时会带上该域（以50个字节为划分单位，目前前50个字节为中奖信息）31电话号码Ans.250CC因为34域无法上送字母或汉字，如果用户号中出现这种情况，则使用该域。但34也必须还保留，可以送上空内容。注意：1、如果一个报文中3
22、1和34域都存在时，34域的信息将会被丢弃。2、31的请求和应答是成对出现的。34电话号码N.28MM35二磁道数据N.37C36三磁道数据N.104C37系统流水号An12M39应答码An2M41终端号Ans8MM42商户号Ans15MM44附件响应数据Ans .3M服务提供商ID号48附件数据Ans.512MO话费查询结果，原值上送49币别代码an3MM15652用户密码B64M银行卡密码63附加数据Ans6M批次号64消息鉴别码B32C9C93.3缴费冲正交易位数据元数据类型发送方及数值备注CEEC信息类型N4042004301位元表B64MM2卡号N.19M3处理码N6MM430xxx
23、4交易金额N12MM充值金额，右对齐，左补零，不带小数点11交易流水N6MM12交易时间N6MMHHMMSS13交易日期N4MMMMDD22POS输入方式N3M30终端打印数据Ans.250C当数据需要终端显示时会带上该域（以50个字节为划分单位，目前前50个字节为中奖信息）31电话号码Ans.250CC因为34域无法上送字母或汉字，如果用户号中出现这种情况，则使用该域。但34也必须还保留，可以送上空内容。注意：1、如果一个报文中31和34域都存在时，34域的信息将会被丢弃。2、31的请求和应答是成对出现的。34电话号码N.28MM35二磁道数据N.37C36三磁道数据N.104C37系统流水
24、号An12M39应答码An2M41终端号Ans8MM42商户号Ans15MM44附加响应数据Ans .3M服务提供商ID号48附加数据Ans.512MO话费查询结果，原值上送49币别代码an3MM15662附加数据Ans6M原交易流水号63附加数据Ans6M批次号64消息鉴别码B32C9C93.4缴费撤消交易位数据元数据类型发送方及数值备注CEEC信息类型N4022002301位元表B64MM2卡号N.19M3处理码N6MM190xxx4交易金额N12MM充值金额，右对齐，左补零，不带小数点(福州该域恒为0)11交易流水N6MM12交易时间N6MMHHMMSS13交易日期N4MMMMDD22P
25、OS输入方式N3M30终端打印数据Ans.250C当数据需要终端显示时会带上该域（以50个字节为划分单位，目前前50个字节为中奖信息）31电话号码Ans.250CC因为34域无法上送字母或汉字，如果用户号中出现这种情况，则使用该域。但34也必须还保留，可以送上空内容。注意：1、如果一个报文中31和34域都存在时，34域的信息将会被丢弃。2、31的请求和应答是成对出现的。34电话号码N.28MM35二磁道数据N.37C36三磁道数据N.104C37系统流水号An12M39应答码An2M41终端号Ans8MM42商户号Ans15MM44附加响应数据Ans .3M服务提供商ID号49币别代码an3M
26、M15652用户密码B64M银行卡密码62附加数据Ans6M原交易流水号63附加数据Ans6M批次号64消息鉴别码B32C9C93.5缴费撤消冲正交易位数据元数据类型发送方及数值备注CEEC信息类型N4042004301位元表B64MM2卡号N.19M3处理码N6MM190xxx4交易金额N12MM充值金额，右对齐，左补零，不带小数点11交易流水N6MM12交易时间N6MMHHMMSS13交易日期N4MMMMDD22POS输入方式N3M30终端打印数据Ans.250C当数据需要终端显示时会带上该域（以50个字节为划分单位，目前前50个字节为中奖信息）31电话号码Ans.250CC因为34域无法
27、上送字母或汉字，如果用户号中出现这种情况，则使用该域。但34也必须还保留，可以送上空内容。注意：1、如果一个报文中31和34域都存在时，34域的信息将会被丢弃。2、31的请求和应答是成对出现的。34电话号码N.28MM35二磁道数据N.37C36三磁道数据N.104C37系统流水号An12M39应答码An2M41终端号Ans8MM42商户号Ans15MM44附加响应数据Ans .3M服务提供商ID号49币别代码an3MM15662附加数据Ans6M原交易流水号63附加数据Ans6M批次号64消息鉴别码B32C9C93.6 定制、委托授权/定制取消、委托消权/手机支付密码修改/手机支付金额上限修
28、改定制、委托授权/定制取消交易、委托消权位域名定义属性请求响应备 注消息类型n401000110MSG-TYPE-ID位元表b64MMBIT MAP2主帐号n.19CM3交易处理码n6MM030XXX4交易金额n12MM必须填0011受卡方系统跟踪号n6MM终端交易流水号12受卡方所在地时间n6Mhhmmss13受卡方所在地日期n4MMMDD14卡有效期n4OCYYMM15清算日期n4MMMDD22服务点输入方式码n3M 25服务点条件码n2MM“00”26服务点PIN获取码n2C当22域指明PIN可输入且持卡人输入PIN 32银行网点代码ans.11CC当是银行柜员机交易时，可填写银行网点代
29、号352磁道数据z.37C当22域指明磁条输入且存在二磁道信息363磁道数据z.104C当22域指明磁条输入且存在三磁道信息37检索参考号An12M定制取消时同原定制交易38授权标识应答码An6M定制取消时同原定制交易39应答码An2M41受卡机终端标识码ans8MM终端代码或银行代码42受卡方标识码ans15MM商户代码44附件响应数据Ans .3M服务提供商ID号48行业特定信息ans.332MM需参考补充说明49交易货币代码An3MM15652个人标识码数据b64C有PIN输入时必选53安全控制信息n16C有安全要求时必选61证件编号Ans60C当持卡人输入证件号63附加数据Ans6M批
30、次号64MACB32MC响应消息中39域为“00”时必选3.7 定制查询交易定制查询位域名定义属性请求响应备 注消息类型n401000210MSG-TYPE-ID位元表b64MMBIT MAP2主帐号n.19CM3交易处理码n6MM刷卡查询：“990000”手工查询：“830000”11受卡方系统跟踪号n6MM终端交易流水号12受卡方所在地时间n6Mhhmmss13受卡方所在地日期n4MMMDD22服务点输入方式码n3M 25服务点条件码n2MM“00”26服务点PIN获取码n2C当22域指明PIN可输入且持卡人输入PIN 32银行网点代码ans.11CC当是银行柜员机交易时，可填写银行网点代
31、号352磁道数据z.37C当22域指明磁条输入且存在二磁道信息363磁道数据z.104C当22域指明磁条输入且存在三磁道信息37检索参考号an12M移动支付系统流水号39应答码an2M41受卡机终端标识码ans8MM终端代码或银行代码42受卡方标识码ans15MM商户代码44附件响应数据Ans .3M服务提供商ID号48行业特定信息ans.400M49交易货币代码an3MM52个人标识码数据b64C有PIN输入时必选53安全控制信息n16CC有安全要求时必选64MACB32MC响应消息中39域为“00”时必选3.8定制、委托授权/定制取消、委托消权/手机支付密码修改/手机支付金额上限修改/定制
32、查询补充说明（48域）(1) 定制、委托授权定制取消、委托消权定制、委托授权/定制取消、委托消权报文、手机支付密码修改、手机支付金额上限修改中的增值交易数据用48域进行自定义，其中前2个字节为用法标志”CI”，后续的数据字段进行如下定义：位置长度格式内容说明22An定制号码一类型目前只允许一个交易定制一个号码420Ans20定制号码一左对齐，右补空格242An定制号码二类型暂不适用2620Ans20定制号码二暂不使用4612n12最高限制金额12位定长数字，最后两位为小数位5812n12最低限制金额12位定长数字，最后两位为小数位708N8定制关系生效日期格式为YYYYMMDD783N3定制关
33、系限期单位为月份，定制关系限期最多为999812N交易类型07或088315Ans接入渠道商ID左对齐，右补空格9840Ans接入渠道商名称/地址左对齐，右补空格13816An运营商方用户密码左对齐，右补空格注意：手机支付二阶密码目前定义为4位1. 定制号码类型：01：短信通知， 02：广电委托03：联通委托04：电信委托05：移动委托 06：联通手机支付07：电信手机支付08：移动手机支付09：泉州广电委托11：中人寿代扣委托12：中人寿代付委托2. 用到的交易类型：07：定制、委托授权，08：取消定制、委托消权，09：修改二阶密码、10：修改支付金额上限(2) 定制查询定制查询报文中48域的定义如下：位置长度格式内容说明21Ans1定制号码个数目前一张卡最多3个手机号一个手机号最多3张卡320Ans20定制号码一左对齐，右补空格2320Ans20定制号码一说明左对齐，右补空格16320Ans20定制号码五左对齐，右补空格18320Ans20定制号码五说明左对齐，右补空格3.9 终端签到位数据元数据类型发送方及数值备注CEEC0信息类型N4080008101位元表B64MM3处理码 N6MM
