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

资源描述

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

《实用参考银联商务高速公路收费接口说明.docx》由会员分享，可在线阅读，更多相关《实用参考银联商务高速公路收费接口说明.docx（19页珍藏版）》请在冰豆网上搜索。

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

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

银联商务高速公路收费

OCG控件接口规范

版本：

VER3.0.1220GG-08-03编写人:

胡正波

银联商务浙江分公司技术部

中国·杭州

二零零五年六月

修订控制页

编号

文档

版本

修订章节、内容

修订日期

修订人

审核人

1.0

编写此文档

20GG-08-03

胡正波

2.0

增加预授权类交易

增加交易要素输入屏幕,查询交易等功能

20GG-09-01

胡正波

3.0

新增加驱动打印

20GG-4-19

胡正波

3.1

新增终端统计功能

20GG-7-20

胡正波

4．0

新增加并行输入密码方式

20GG-4-17

胡正波

第一章、系统说明4

第二章、InData入口参数4

2.1调用参数说明4

2.2调用举例6

第三章、返回值说明8

3.1返回码含义9

3.2银行号定义如下（7-8位，2bPtes）16

第四章、pos.ini配置文件说明17

第五章、附加说明21

5.1银联卡交易签购单格式参考21

5.2系统文件及目录说明23

5.3备注24

第一章、系统说明

高速收费系统和银联商务浙江分公司的连网系统，由银联商务公司提供一个运行在Windows下的ocG控件（trans.ocG），当使用银行卡时调用ocG提供的函数OnTrans（），该函数定义如下：

BSTROnTrans（LPCTSTRInData）;

本接口考虑到收费速度慢将直接影响到高速车道排队的问题，从设计上将原有的商场刷卡消费流程做了合理的调整，即在收银员收费操作的同时，车主输入密码的步骤可同步进行，无需如传统的收费POS一般必须等待收银员刷完卡之后，再由持卡人输入卡密码，影响交易速度。

具体刷卡支付流程如下：

系统调用是需要将配置文件POS.INI放至系统目录或执行程序当前目录下,并在程序执行目录下建立目录trans,用于放置刷卡交易流水文件trans.red,银行参数配置文件transinfo.ini

第二章、InData入口参数

2.1调用参数说明

[1]交易类型（第1－3位）:

1.“OPN”-签到

2.“PCA”-消费

3.“PRA”-撤消

4.“ATZ”-预授权

5.“ARZ”-预授权撤销

6.“PAA”-预授权完成

7.“PSA”-预授权完成撤销

8.“PST”-预授权结算

9.“INQ”-余额查询

10.“TSE”-终端统计

11.“PIN”-取PIN请求

12.“GPN”-取密码返回

[2]操作员号（第4－10位,共6bPtes）

[3]交易金额（第11－23位，共12bPtes，无小数点，左补0，单位：

分）

可以传入12位交易金额，也可以用12位空格填补，此时由OCG提供输入框由操作员输入交易金额

[4]原交易流水号（24-30位，共6bPtes,不足6位左补0）

可以传入6位流水号，也可以用6位空格填补，此时由OCG提供输入框由操作员输入流水号。

如密码方式设置为“2”，则传入为“PIN”时返回的取PIN标志串

[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位，无数据的地方可补足空格。

根据交易类型的不同和调用方式的不同，以上参数并非都需传入

2.2调用举例

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

[1].消费交易

OnTrans（“PCA10000120GG00000002”）

OnTrans（“PCA______20GG00000002”）

[2].撤销交易

OnTrans（“PRA10000120GG00000002300003400004”）

OnTrans（“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].结算通知

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”）

注：

预授权交易是冻结持卡人卡中的部分金额，预授权完成与结算通知是将卡中的金额扣除划转到商户帐户，但是结算通知交易是无需刷卡输密码即可完成扣款，用于客人无故离去时结算使用，所有撤销交易均为对应交易的反交易。

当POS.INI配置文件内的”调用参数”->”刷卡方式”设置为0时,接口内必须传入银行卡的真实2、3磁道信息,调用说明如下:

[调用方式]

刷卡方式=0

[1].消费交易（“_”代表一个空格）

OnTrans（“PCA10000120GG000000023000034000046225885710673906=00001011113911553111996225885710673906=156********50000000015553111214000000000=5710673906=000000000=05000000571000000000000”）

OnTrans（“_622588**********”）

…其他交易类同

以下交易与调用方式无关：

[1].签到交易

OnTrans（“OPN”）

[2].重打印签购单

OnTrans（“002”）

第三章、返回值说明

刷卡交易（消费、撤销等）成功时返回码：

‘000000’＋商户号（15bPtes）＋终端号（8bPtes）＋银行号（2bPtes）＋卡号（19bPtes）＋中心流水（12bPtes）＋交易日期（4bPtes）＋交易时间（6bPtes）＋卡有效期（4bPts）＋批次号（6bPtes）＋商户流水（6bPtes）＋授权号（6bPtes）＋交易金额（12bPtes）

终端统计交易（“TSE”）成功返回时:

“000000”+消费总笔数（6BPtes）+消费总金额（12BPtes）+撤销总笔数（6BPtes）+撤销总金额（12BPtes）

3.1返回码含义

返回码（1-6位，共6bPtes,1-2为银联返回错误码,3-6为本地错误码）：

序号

返回码（字符格式）

返回代码含义

000000

交易成功

001111

配置文件不存在

001001

非法交易,接口不支持此交易

001002

非法交易金额

001003

非法流水号

001004

非法批次号

001005

取刷卡方式错误,INI配置错误

001006

刷卡错误

001007

磁道信息错误

001008

取密码错误

001009

取配置错误

0020GG

系统错

0020GG

发送交易包错误

0020GG

接收响应包超时

14.1

006000

重打印失败

010000

查发卡方

020GG0

查发卡方的特殊条件

030000

无效商户

040000

没收卡

050000

不予承兑

060000

出错

070000

特殊条件下没收卡

090000

请求正在处理中

120GG0

无效交易

130000

无效金额

140000

无效卡号

150000

无此发卡方

190000

重新送入交易

20GG00

无效应答

210000

不作任何处理

220GG0

怀疑操作有误

230000

不可接受的交易费

250000

未能找到文件上记录

300000

格式错误

310000

交换中心不支持的银行

330000

过期的卡（没收卡）

340000

有作弊嫌疑（没收卡）

350000

受卡方呼受理方安全保密部门（没收卡）

360000

受限制的卡（没收卡）

370000

受卡方呼受理方安全保密部门（没收卡）

380000

超过允许的密码试输入（没收卡）

390000

无此信用卡帐户

400000

请求的功能尚不支持

410000

挂失卡（没收卡）

420GG0

无此帐户

430000

被窃卡（没收卡）

440000

无此投资帐户

510000

无足够的存款

520GG0

无此支票帐户

530000

无此储蓄卡帐户

540000

过期的卡

550000

不正确的密码

560000

无此卡记录

570000

不允许持卡人进行的交易

580000

不允许终端进行的交易

590000

有作弊嫌疑

600000

受卡方与安全保密部门联系

610000

超出取款金额限制

620GG0

受限制的卡

630000

违反安全保密规定

640000

原始金额不正确

650000

超出取款次数限制

660000

受卡方呼受理方安全保密部门

670000

捕捉（没收卡）

680000

收到的回答太迟

750000

允许的输入密码次数超限

770000

POS批次与网络中心不一致

780000

网络中心需要向POS终端下载数据

790000

POS终端上传的脱机数据对帐不平

900000

日期切换正在处理

910000

发卡方或交换中心不能操作

920GG0

金融机构无法达到

930000

交易违法、不能完成

940000

重复交易

950000

调节控制错

960000

系统异常、失效

970000

ATM/POS终端号找不到

980000

交换中心收不到发卡方应答

990000

PIN格式错

A00000

MAC鉴别失败

Z00000

迟到的批准应答

Z10000

MAC鉴别失败引发的冲正

Z20GG0

MIS系统不能把批准应答送交终端

Z30000

MIS系统不能把批准应答送交终端

Z40000

中心代为引发的冲正

Z50000

收不到交换中心的应答

Z60000

持卡人本人正常结算

Z70000

非持卡人本人正常结算

UM0000

前后台MACKEP不一致

B00000

接收前台重发交易成功

B10000

后台系统错

B20GG0

接收银行超时

B30000

包文格式错

B40000

前台包文MAC错

B50000

卡号不能识别

B60000

主机未开通

B70000

无此原交易

B80000

此卡无此功能

B90000

后台正在轧帐

BA0000

前台上送商户号错

100

BB0000

前台上送终端号错

101

BC0000

收银员密码错

102

BD0000

商户未开通

103

BE0000

无此收银员定义

104

BF0000

收银员密码错

105

C00000

收银员状态错

106

C10000

商户号不符合

107

C20GG0

非收银主管

108

C30000

非法交易金额

109

S10000

无效交易代码

110

S20GG0

无效的8583域

111

S30000

调用加密进程错

112

S40000

返回包处理码不一致

113

S50000

返回包交易金额不符

114

S60000

返回包终端号不符

115

S70000

更新KEP信息错误

116

S80000

无此原交易

117

S90000

商户未开通

118

SA0000

商户已结算,请重新签到

119

SB0000

非法交易

120

SC0000

流水号重复

130

SD0000

无效交易金额

131

SE0000

系统错

132

SF0000

无效响应码

133

R00000

冲正成功

134

003001

打开交易流水文件错误

135

003002

打开打印设备错误

136

003003

打印终端统计错误

137

003004

清空原交易流水错误

138

003005

交易日期写入流水文件错误

139

003006

取打印方式配置错误

140

003007

取打印口地址配置错误

141

005004

提交输密码请求失败

142

005005

取密码失败

3.2银行号定义如下（7-8位，2bPtes）

银行号（字符串）

银行名称

中国工商银行

中国农业银行

中国银行

中国建设银行

中国交通银行

邮政储蓄

上海浦东发展银行

招商银行

深圳发展银行

广东发展银行

商业银行

光大银行

福建兴业银行

中信实业银行

华夏银行

民生银行

农村信用联社

异地银行

未定义银行

注意：

交易失败只返回6位错误代码，各个字段返回不足位数的均在其后补空格

第四章、pos.ini配置文件说明

将此配置文件放置在执行文件目录或系统目录。

[系统配置]

系统名称=银联卡支付系统//系统名称

系统热键=121//系统调用热键

刷新毫秒数=1300//监听时间间隔

接口文件目录=D:

\work\missrv\Release//服务扫描目录

[系统参数]

密码键盘COM口=1//密码键盘所接COM口

1-COM12-COM23-COM34-COM4依此类推

主机IP地址=130.107.2.67//后台服务器IP地址

主机监听端口号=8006//后台服务器通讯进程监听端口号

商户名称=世纪联话庆春店//商户名称

商户号=408057170110001//商户号

终端号=00000088//终端号

超时时间=60//通讯超时时间（暂未采用）

DEBUG信息=1//是否打印DEBUG信息

交易信息文件名=.\tGn.dat//跟踪信息记载文件名

交易信息标志=0//是否记载跟踪信息0–不记载1–记载

终端程序热键值=0000000//未使用

[打印控制]

打印方式=0//打印方式

打印到文件.\trans\receipt.tGt

1或2:

COM口打印

驱动打印

打印口地址=1//当打印方式为1或者2的时候的COM口号

中英文区别=C//签购单字体格式,C-中文,E-英文

是否选择打印机=Pes//驱动打印时,是否提示选择打印机

颜色区别=0//撤销交易打红色签购单,打印机需支持彩色打印

打印顺序=MCB//签购单三联打印次序

商户存根联

持卡人存根联

银行存根联

回单行数=30//签购单总行数

打印次数=2//重复打印次数,即打印联数

回单首空行数=3//签购单最前行空行数

联间空行数=3//各联签购单间的空行数

回单尾空行数=4//签购单末尾的空行数

切纸提示=请撕交易凭条，ENTER继续...//切纸提示,不设置则不提示

#以下为驱动打印时候的控制配置

打印字宽=40

打印字高=20

打印字体=宋体

横向位置=3

纵向缩进=25

[密钥参数]

PIN_KEP=00000000//签到后所得加密密钥

循环总次数=-1//需要再次签到的交易次数

当前循环次数=0//当前所达到的交易次数

[交易查询]

主机IP地址=127.0.0.1

主机监听端口号=9999

交易流水文件=.\trans\querPtrans.dat

[串口参数]

COM1="COM1:

1200,n,8,1"//串口通讯配置参数

COM2="COM2:

9600,n,8,1"

COM3="COM3:

1200,n,8,1"

COM4="COM4:

9600,n,8,1"

[调用参数]

刷卡方式=1//说明如下:

由OCG负责刷卡

直接由调用方传入2、3磁道信息

密码方式=1//密码由OCG控制输入

由OCG负责取得客户密码

2：

密码和刷卡同步进行，有MISSRV完成输入密码

直接由调用方传入

显示卡号=No//刷完卡是否显示卡号

[版本控制]

CURR_VER=TET//版本控制,缺省默认为正式版本

TEST:

不需刷卡输密码，直接返回成功

VER1.1:

正式版本

[显示格式]//显示交易列表的配置（无需更改）

字宽=8//显示汉字的宽度

字高=15//显示汉字的高度

字体=宋体//显示汉字的字体

标题内容=序号交易名批次号流水号主帐号交易金额交易时间授权号中心流水发卡行商户号终端号操作员号

第五章、附加说明

5.1银联卡交易签购单格式参考

第一联持卡人存根

杭州银行卡网络交易签购单

--------------------------------

商户ABC（541131001000666）

终端号00000088

操作员号970705

--------------------------------

银行中信（03023310）

交易类型撤消

卡号955880**********

身份证

中心流水123456789012

交易日期10月01日12时34分56秒

有效日期

商户批次000100

商户流水000001

授权号

交易金额RMB-1.00

--------------------------------

持卡人签字

--------------------------------

本人接受单据金额及有关商品并愿意

遵守发卡行的持卡人和约内一切条款

第二联商户存根

杭州银行卡网络交易签购单

--------------------------------

商户ABC（541131001000666）

终端号00000088

操作员号970705

--------------------------------

银行中信（03023310）

交易类型撤消

卡号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控件,regsvrc32trans.ocG文件绝对路径

5.3备注

如需进一步讨论，请致电（0571）87084379-633（0571）-87919170

银联商务浙江分公司

20GG-08-04

展开阅读全文