实用参考银联商务高速公路收费接口说明.docx

1、实用参考银联商务高速公路收费接口说明银联商务高速公路收费 OCG控件接口规范版本：VER3.0.12 20GG-08-03 编写人:胡正波 银联商务浙江分公司技术部中国杭州二零零五年六月修订控制页编 号文档版本修订章节、内容修订日期修订人审核人11.0编写此文档20GG-08-03胡正波22.0增加预授权类交易增加交易要素输入屏幕,查询交易等功能20GG-09-01胡正波33.0新增加驱动打印20GG-4-19胡正波43.1新增终端统计功能20GG-7-20胡正波540新增加并行输入密码方式20GG-4-17胡正波 第一章、系统说明 4第二章、InData入口参数 42.1 调用参数说明 42

2、.2 调用举例 6第三章、返回值说明 83.1 返回码含义 93.2 银行号定义如下（7-8位，2bPtes） 16第四章、pos.ini配置文件说明 17第五章、附加说明 215.1银联卡交易签购单格式参考 215.2系统文件及目录说明 235.3备注 24第一章、系统说明高速收费系统和银联商务浙江分公司的连网系统，由银联商务公司提供一个运行在Windows下的ocG控件（trans.ocG），当使用银行卡时调用ocG提供的函数OnTrans()，该函数定义如下：BSTR OnTrans(LPCTSTR InData);本接口考虑到收费速度慢将直接影响到高速车道排队的问题，从设计上将原有的商

3、场刷卡消费流程做了合理的调整，即在收银员收费操作的同时，车主输入密码的步骤可同步进行，无需如传统的收费POS一般必须等待收银员刷完卡之后，再由持卡人输入卡密码，影响交易速度。具体刷卡支付流程如下：系统调用是需要将配置文件POS.INI放至系统目录或执行程序当前目录下,并在程序执行目录下建立目录trans,用于放置刷卡交易流水文件trans.red,银行参数配置文件transinfo.ini第二章、InData入口参数2.1 调用参数说明1 交易类型（第13位）:1. “OPN” -签到2. “PCA” -消费3.“PRA” -撤消4. “ATZ”-预授权5. “ARZ”-预授权撤销6. “PA

4、A”-预授权完成7. “PSA”-预授权完成撤销8. “PST”-预授权结算9. “INQ”-余额查询10. “TSE”-终端统计11. “PIN”-取PIN请求12. “GPN”-取密码返回2 操作员号(第410位,共6bPtes)3 交易金额（第1123位，共12bPtes，无小数点，左补0，单位：分）可以传入12位交易金额，也可以用12位空格填补，此时由OCG提供输入框由操作员输入交易金额4 原交易流水号(24-30位，共6bPtes,不足6位左补0)可以传入6位流水号，也可以用6位空格填补，此时由OCG提供输入框由操作员输入流水号。如密码方式设置为“2”，则传入为“PIN”时返回的取P

5、IN标志串5 原交易批次号(31-37位,共6bPtes,不足6位左补0) 可以传入6位批次号，也可以用6位空格填补，此时由OCG提供输入框由操作员输入批次号 6 track2(38 75位，共37bPtes，2磁道信息，不足37后填空格)7 track3(76 180位，共104bPtes,3磁道信息，不足104后填空格)TRACK2，TRACK3在刷卡方式设置为0时必须传入此2磁道信息，如果刷卡方式设置为1时，无需传入此2磁道信息注意: 以上参数每项的位置必须固定，如要传入交易金额，则金额必须放在InStr的第11-23位，无数据的地方可补足空格。根据交易类型的不同和调用方式的不同，以上参

6、数并非都需传入2.2 调用举例为了进一步减少客户开发刷卡程序的工作量，银联商务OCG提供了交易金额、批次号、流水号等信息输入界面，客户只需传递空格替代交易金额、流水号、批次号等字段的位置，OCG即会显示输入框，供用户输入交易金额、流水号、批次号等信息,但是考虑到手工输入交易金额可能会与实际购物金额不符,交易金额还是由程序直接传入为好.具体调用如下：1.消费交易OnTrans(“PCA10000120GG00000002”) OnTrans(“PCA_20GG00000002”)2.撤销交易OnTrans(“PRA10000120GG00000002300003400004”)OnTrans(“

7、PRA_”)3.预授权 OnTrans(“ATZ10000120GG00000002”) OnTrans(“ATZ_20GG00000002”)4.预授权撤销OnTrans(“ARZ10000120GG00000002300003400004”)OnTrans(“ARZ_20GG00000002_”)5.预授权完成OnTrans(“PAA10000120GG00000002”)OnTrans(“PAA_20GG00000002”)6.预授权完成撤销OnTrans(“PSA10000120GG00000002300003400004”)OnTrans(“PSA_20GG00000002_”)7.

8、结算通知OnTrans(“PST10000120GG00000002300003400004”)OnTrans(“PST_20GG00000002_”) 8.余额查询OnTrans(“INQ”) 9.终端统计 OnTrans(“TSE”) OnTrans(“TSE100001”)10. 取PIN请求 OnTrans(“PIN10000120GG00000002”) OnTrans(“PIN_20GG00000002”)11. 取密码返回 OnTrans(“GPN10000120GG00000002300003”) OnTrans(“GPN_300003”)注：预授权交易是冻结持卡人卡中的部分金

9、额，预授权完成与结算通知是将卡中的金额扣除划转到商户帐户，但是结算通知交易是无需刷卡输密码即可完成扣款，用于客人无故离去时结算使用，所有撤销交易均为对应交易的反交易。当POS.INI配置文件内的”调用参数”-”刷卡方式”设置为0时,接口内必须传入银行卡的真实2、3磁道信息,调用说明如下:调用方式刷卡方式=01.消费交易(“_”代表一个空格)OnTrans(“PCA10000120GG000000023000034000046225885710673906=00001011113911553111996225885710673906=156*500000000155531112140000000

10、00=5710673906=000000000=05000000571000000000000”)OnTrans(“_622588*”)其他交易类同以下交易与调用方式无关：1.签到交易OnTrans(“OPN”)2.重打印签购单OnTrans(“002”)第三章、返回值说明刷卡交易（消费、撤销等）成功时返回码： 000000 商户号（15bPtes）终端号(8bPtes)银行号(2bPtes)卡号(19bPtes)中心流水(12bPtes)交易日期(4bPtes)交易时间(6bPtes)卡有效期(4bPts)批次号(6bPtes)商户流水(6bPtes)授权号(6bPtes)交易金额(12bP

11、tes)终端统计交易(“TSE”)成功返回时: “000000”+消费总笔数(6BPtes) + 消费总金额(12BPtes)+撤销总笔数(6BPtes)+撤销总金额(12BPtes)3.1 返回码含义返回码（1-6位，共6bPtes,1-2为银联返回错误码,3-6为本地错误码）：序号返回码(字符格式) 返回代码含义1000000交易成功2001111配置文件不存在3001001非法交易,接口不支持此交易4001002非法交易金额5001003非法流水号6001004非法批次号7001005取刷卡方式错误,INI配置错误8001006刷卡错误9001007磁道信息错误10001008取密码错误

12、11001009取配置错误120020GG系统错130020GG发送交易包错误140020GG接收响应包超时14.1006000重打印失败15010000查发卡方16020GG0查发卡方的特殊条件17030000无效商户18040000没收卡19050000不予承兑20060000出错21070000特殊条件下没收卡22090000请求正在处理中23120GG0无效交易24130000无效金额25140000无效卡号26150000无此发卡方27190000重新送入交易2820GG00无效应答29210000不作任何处理30220GG0怀疑操作有误31230000不可接受的交易费3225000

13、0未能找到文件上记录33300000格式错误34310000交换中心不支持的银行35330000过期的卡（没收卡）36340000有作弊嫌疑（没收卡）37350000受卡方呼受理方安全保密部门（没收卡）38360000受限制的卡（没收卡）39370000受卡方呼受理方安全保密部门（没收卡）40380000超过允许的密码试输入（没收卡）41390000无此信用卡帐户42400000请求的功能尚不支持43410000挂失卡（没收卡）44420GG0无此帐户45430000被窃卡（没收卡）46440000无此投资帐户47510000无足够的存款48520GG0无此支票帐户49530000无此储蓄卡帐

14、户50540000过期的卡51550000不正确的密码52560000无此卡记录53570000不允许持卡人进行的交易54580000不允许终端进行的交易55590000有作弊嫌疑56600000受卡方与安全保密部门联系57610000超出取款金额限制58620GG0受限制的卡59630000违反安全保密规定60640000原始金额不正确61650000超出取款次数限制62660000受卡方呼受理方安全保密部门63670000捕捉（没收卡）64680000收到的回答太迟65750000允许的输入密码次数超限66770000POS批次与网络中心不一致67780000网络中心需要向POS终端下载数

15、据68790000POS终端上传的脱机数据对帐不平69900000日期切换正在处理70910000发卡方或交换中心不能操作71920GG0金融机构无法达到72930000交易违法、不能完成73940000重复交易74950000调节控制错75960000系统异常、失效76970000ATM/POS终端号找不到77980000交换中心收不到发卡方应答78990000PIN 格式错79A00000MAC鉴别失败80Z00000迟到的批准应答81Z10000MAC鉴别失败引发的冲正82Z20GG0MIS系统不能把批准应答送交终端83Z30000MIS系统不能把批准应答送交终端84Z40000中心代为

16、引发的冲正85Z50000收不到交换中心的应答86Z60000持卡人本人正常结算87Z70000非持卡人本人正常结算88UM0000前后台MACKEP不一致89B00000接收前台重发交易成功90B10000后台系统错91B20GG0接收银行超时92B30000包文格式错93B40000前台包文MAC错94B50000卡号不能识别95B60000主机未开通96B70000无此原交易97B80000此卡无此功能98B90000后台正在轧帐99BA0000前台上送商户号错100BB0000前台上送终端号错101BC0000收银员密码错102BD0000商户未开通103BE0000无此收银员定义10

17、4BF0000收银员密码错105C00000收银员状态错106C10000商户号不符合107C20GG0非收银主管108C30000非法交易金额109S10000无效交易代码110S20GG0无效的8583域111S30000调用加密进程错112S40000返回包处理码不一致113S50000返回包交易金额不符114S60000返回包终端号不符115S70000更新KEP信息错误116S80000无此原交易117S90000商户未开通118SA0000商户已结算,请重新签到119SB0000非法交易120SC0000流水号重复130SD0000无效交易金额131SE0000系统错132SF00

18、00无效响应码133R00000冲正成功134003001打开交易流水文件错误135003002打开打印设备错误136003003打印终端统计错误137003004清空原交易流水错误138003005交易日期写入流水文件错误139003006取打印方式配置错误140003007取打印口地址配置错误141005004提交输密码请求失败142005005取密码失败3.2 银行号定义如下（7-8位，2bPtes）银行号(字符串) 银行名称 01中国工商银行 02中国农业银行 03中国银行 04中国建设银行 05中国交通银行 06邮政储蓄 07上海浦东发展银行 08招商银行 09 深圳发展银行 10

19、广东发展银行11商业银行12光大银行13福建兴业银行14中信实业银行15华夏银行16民生银行17农村信用联社20异地银行55未定义银行注意：交易失败只返回6位错误代码，各个字段返回不足位数的均在其后补空格第四章、pos.ini配置文件说明将此配置文件放置在执行文件目录或系统目录。系统配置系统名称=银联卡支付系统 /系统名称系统热键=121 /系统调用热键刷新毫秒数=1300 /监听时间间隔接口文件目录=D:workmissrvRelease/服务扫描目录系统参数密码键盘COM口=1 /密码键盘所接COM口 1-COM1 2-COM2 3-COM3 4-COM4依此类推主机IP地址=130.10

20、7.2.67 /后台服务器IP地址主机监听端口号=8006 /后台服务器通讯进程监听端口号商户名称=世纪联话庆春店 /商户名称商户号=408057170110001 /商户号终端号=00000088 /终端号超时时间=60 /通讯超时时间(暂未采用)DEBUG信息=1 /是否打印DEBUG信息交易信息文件名=.tGn.dat/跟踪信息记载文件名交易信息标志=0 /是否记载跟踪信息 0 不记载 1 记载终端程序热键值=0000000 /未使用打印控制打印方式=0 /打印方式0:打印到文件.trans receipt.tGt 1或2:COM口打印 3:驱动打印打印口地址=1 /当打印方式为1或者2

21、的时候的COM口号中英文区别=C /签购单字体格式,C-中文,E-英文是否选择打印机=Pes /驱动打印时,是否提示选择打印机颜色区别=0 /撤销交易打红色签购单,打印机需支持彩色打印打印顺序=MCB /签购单三联打印次序 M:商户存根联 C:持卡人存根联 B:银行存根联回单行数=30 /签购单总行数打印次数=2 /重复打印次数,即打印联数回单首空行数=3/签购单最前行空行数联间空行数=3 /各联签购单间的空行数回单尾空行数=4/签购单末尾的空行数切纸提示=请撕交易凭条，ENTER继续./切纸提示,不设置则不提示#以下为驱动打印时候的控制配置打印字宽=40打印字高=20打印字体=宋体横向位置=

22、3纵向缩进=25密钥参数PIN_KEP=00000000 /签到后所得加密密钥循环总次数=-1 /需要再次签到的交易次数当前循环次数=0 /当前所达到的交易次数交易查询主机IP地址=127.0.0.1主机监听端口号=9999交易流水文件=.transquerPtrans.dat串口参数COM1=COM1:1200,n,8,1 /串口通讯配置参数COM2=COM2:9600,n,8,1COM3=COM3:1200,n,8,1COM4=COM4:9600,n,8,1调用参数刷卡方式=1 /说明如下: 1:由OCG负责刷卡0:直接由调用方传入2、3磁道信息密码方式=1 /密码由OCG控制输入1:由O

23、CG负责取得客户密码2：密码和刷卡同步进行，有MISSRV完成输入密码0:直接由调用方传入显示卡号=No /刷完卡是否显示卡号版本控制CURR_VER=TET/版本控制,缺省默认为正式版本 TEST:不需刷卡输密码，直接返回成功 VER1.1:正式版本显示格式/显示交易列表的配置(无需更改)字宽=8 /显示汉字的宽度字高=15 /显示汉字的高度字体=宋体 /显示汉字的字体标题内容= 序号 交 易 名 批次号 流水号 主 帐 号 交 易 金 额 交易时间 授权号 中心流水 发卡行 商 户 号 终 端 号 操作员号第五章、附加说明5.1银联卡交易签购单格式参考第一联 持卡人存根 杭州银行卡网络交易

24、签购单-商户 ABC(541131001000666)终端号 00000088操作员号 970705-银行 中信(03023310)交易类型 撤消卡号 955880*身份证 中心流水 123456789012交易日期 10月01日12时34分56秒有效日期 商户批次 000100商户流水 000001授权号 交易金额 RMB -1.00-持卡人签字 -本人接受单据金额及有关商品并愿意遵守发卡行的持卡人和约内一切条款 第二联 商户存根 杭州银行卡网络交易签购单-商户 ABC(541131001000666)终端号 00000088操作员号 970705-银行 中信(03023310)交易类型 撤

25、消卡号 955880*身份证 中心流水 123456789012交易日期 10月01日12时34分56秒有效日期 商户批次 000100商户流水 000001授权号 交易金额 RMB -1.00-持卡人签字 -本人接受单据金额及有关商品并愿意遵守发卡行的持卡人和约内一切条款 5.2系统文件及目录说明 1、必须要将POS.INI文件拷贝至系统目录, W98、W95为Windows目录， W20GG,WGp为Winnt目录； 2、需要在可执行文件目录下新建一个名为TRANS的目录，用于存放本地交易数据文件 3、将transinfo.ini文件拷贝至可执行文件目录 4、如果为WIN95第一版的系统，还需要将sPsdll目录内的DLL拷贝到系统目录 5、注册TRANS.OCG控件,regsvrc32 trans.ocG文件绝对路径 5.3备注如需进一步讨论，请致电 (0571)87084379-633 (0571)-87919170 银联商务浙江分公司 20GG-08-04