金融POS机与收银机标准函数接口说明windows版本.docx
- 文档编号:1805466
- 上传时间:2022-10-24
- 格式:DOCX
- 页数:17
- 大小:36.96KB
金融POS机与收银机标准函数接口说明windows版本.docx
《金融POS机与收银机标准函数接口说明windows版本.docx》由会员分享,可在线阅读,更多相关《金融POS机与收银机标准函数接口说明windows版本.docx(17页珍藏版)》请在冰豆网上搜索。
金融POS机与收银机标准函数接口说明windows版本
金融POS机与收银机
标准接口函数说明
2013年3月
(一)动态库接口定义
///
LIBSAND.DLL(WIN)LIBSAND.SO(LINUX)
///ZLSH.LIB(DOS)
///函数名称:
card_trans
///函数功能:
按传入数据完成刷卡任务
///com串口号
///upData传入数据
///downData传出数据
///
voidcard_trans(intcom,char*upData,char*downData);
1.传入传出数据结构定义:
(C语言)
structstrTransUp{structstrTransDown{
charOperateType[2];charOperateType[2];
charTransType[2];charTransType[2];
charCardType[2];charCardType[2];
charCashRegNo[6];charResponseCode[2];
charCasherNo[6];charResponseMsg[40];
charAmount[12];charCashRegNo[6];
charCashTraceNo[6];charCasherNo[6];
charOriginTraceNo[6];charAmount[12];
charReserved[48];charSellteNum[6];
};charMerchantID[15];
charMerchantName[40];
charTerminalID[8];
charCardNo[19];
charExp_Date[4];
charBankNo[6];
charTransDate[8];
charTransTime[6];
charAuth_Code[6];
charSysRefNo[12];
charCashTraceNo[6];
charOriginTraceNo[6];
charSysTracdNo[6];
charOriginSysTraceNo[6];
charReserved[48];
};
批次(概念):
上一笔结算到本次结算之间称为一批次。
撤销(概念):
当批次且当天内对之前一笔消费(当天)进行全额撤销。
正常情况下一天营业结束做结算,所以以当天为撤销的有效期。
退货(概念):
隔天,对前一笔消费进行全额或部分退货。
金额问题:
传入金额为收银机传入需要消费或撤销的金额,传出金额为实际的消费或撤销金额,固将传入金额与传出金额做比较。
(联华OK卡交易,如下发金额大于卡内余额,联华后台会将卡内余额扣掉,返回实际的交易金额,所以联华OK卡交易时要判断金额)。
2.传入字段说明:
字段名称
长度
数据类型
备注
操作类型
2
ASC
固定值(见操作类型表)
交易类型
2
ASC
固定值(见交易类型表)
卡类型
2
ASC
固定值(见卡类型表)
收银机编号
6
ASC
商场内唯一(左补零,无则全补空格)
柜员号
6
ASC
(左补零,无则全补空格)
金额
12
ASC
以分位单位(左补零)
收银流水号
6
ASC
同一收银机内唯一(左补零,无则全补空格)
系统流水号
6
ASC
撤销时填写
预留字段
48
ASC
银行卡退货交易时,左起12位参照号4位日期MMDD
支付宝、微信条码支付交易时付款码从左起传入条形码
3.传出字段说明:
字段名称
长度
数据类型
备注
操作类型
2
ASC
固定值(见操作类型表)
交易类型
2
ASC
固定值(见交易类型表)
卡类型
2
ASC
固定值(见卡类型表)
返回码
2
ASC
“00”为成功,其它详见错误返回码表
返回信息
40
ASC
返回码对应的信息
收银机编号
6
ASC
柜员号
6
ASC
金额
12
ASC
交易的实际金额,以分位单位(左补零)
联华OK卡交易,如下发金额大于卡内余额,联华后台会将卡内余额扣掉,返回实际的交易金额,所以联华OK卡交易时要判断金额
银行卡交易金额返回为收银机下发金额。
结算批次
6
ASC
商户号
15
ASC
商户名称
40
ASC
终端号
8
ASC
卡号
19
ASC
卡有效期
4
ASC
发卡行编码
6
ASC
(见发卡行编码表)
交易日期
8
ASC
YYYYMMDD
交易时间
6
ASC
HHMMSS
授权号
6
ASC
系统参照号
12
ASC
退货时要用到的参照号
收银流水号
6
ASC
原收银流水号
6
ASC
撤销原样返回
系统流水号
6
ASC
原系统流水号
6
ASC
预留字段
48
ASC
巍康和斯玛特交易时,返回12位卡余额+24位斯玛特批次号
联华卡交易时,返回12位卡余额+15票据号
微信、支付宝的交易,返回的应是交易号,最大长度为32
有优惠交易时,预留字段前12位放实际交易金额,后12位放优惠金额。
(二)相关表定义
1.操作类型表:
操作代码
操作类型
备注
“A0”
交易
返回“A1”
“B0”
查询
返回“B1”
…
…
…
2.交易类型表:
交易代码
交易类型
备注
“30”
消费
返回“31”
“40”
撤销
返回“41”
“50”
退货
返回“51”(支持部分退货功能)
“90”
初始化
斯玛特,巍康卡用,银行卡无此项
“91”
签到
返回“91”
“92”
结算
返回“92”
“80”
余额查询
返回“81”
“EG”
条码支付消费
返回“EH”
“EI”
条码支付撤销
返回“EJ”
3.卡类型表:
卡类型
卡名
备注
01
银行卡
02
会员卡
03
SMART卡
05
联华OK卡
06
巍康卡
07
联华积点卡
12
畅购卡
25
苏州通
26
北京瑞通
27
北京奥斯卡
29
同方会员卡
30
巾帼卡
31
东方文化卡
32
美廉美会员卡
33
便利通卡
34
索迪斯
39
高汇通
40
纽斯达卡
41
移动手机钱包(交易)
42
都市旅游卡
43
上海公交卡
45
交行分期
48
得仕卡
49
AEONJUSCO卡
51
银商购物卡
51
银商资讯卡(徐家汇)
57
雅高在线磁条卡
58
雅高在线IC卡
59
山东一卡通
61
南京市民卡
62
雅高脱机卡
64
招行积分一体化
65
综合保险卡
66
苏州一卡通消费
67
唐山远洋城
68
羊城通卡
69
普天银通磁条卡
70
普天银通非接卡
73
大众商务卡
74
指付通
75
欧诺卡
77
润通赢点通
78
徐家汇商城卡
79
锦江磁条卡
80
共享一卡通
83
开心购卡
86
东方CJ礼品卡
87
建行积分
88
爱心卡
89
无锡市民卡
90
易士卡
91
商盟卡
92
瑞祥商务卡
93
电信翼支付
95
河北一卡通
96
中国移动手机支付- NFC支付
98
爱农智慧卡
E1
信联卡
E2
中欣支付卡
E3
春秋商旅卡
E4
发达卡
E5
交行信用卡积分
E7
苏州通充值
E8
瑞得卡
E9
杉德银行积分(平安)
F2
壹卡会
F3
付费通
F4
索迪斯磁条卡
F5
平安付壹钱包
F6
广发积分
F7
上海银行积分
F8
支付宝当面付
G1
新生易卡
G2
微信支付
G3
格林豪泰储值卡
4.字段与交易类型关系表:
(M为必填字段)
交易类型
操作类型
交易类型
卡类型
收银机编号
操作员号
金额
收银机流水号
原收银机流水号
预留字段
消费
A0
30
M
M
撤销
A0
40
M
M
M
退货
A0
50
M
M
M
初始化
A0
90
M
签到
A0
91
M
结算
A0
92
M
银行卡余额查询
A0
80
M
条码消费
A0
EG
M
M
M
条码撤销
A0
EI
M
M
M
M
…
…
…
…
…
…
…
…
…
…
5.条码支付交易流程
附录二动态库返回码表:
(动态库只返回串口通讯上的错误)
代码
错误信息
备注
D1
“LRC校验错误”
几乎不会有此错误
16
“初始化COM错误”
设备被占用或没找到
D2
“打开COM错误”
线路不通时返回(常见)
D3
“接收COM错误”
几乎不会有此错误
D4
“发送COM错误”
几乎不会有此错误
D6
“操作类型错误”
几乎不会有此错误
D7
“交易类型错误”
几乎不会有此错误
13
“交易金额错误”
几乎不会有此错误
……
……
……
附录三其它部分返回码及信息
代码
返回信息
含义
00
ApprovedOrCompletedSuccessfully
承兑或交易成功
01
ReferToCardIssuer
查发卡方
02
ReferToCardIssuer'sSpecialCondition
查发卡方的特殊条件
03
InvalidMerchant
无效商户
04
Pick-up
没收卡
05
DoNotHonor
不予承兑
06
Error
出错
07
Pick-upCard,SpecialCondition
特殊条件下没收卡
09
RequestInProgress
请求正在处理中
12
InvalidTransaction
无效交易
13
InvalidAmount
无效金额
14
InvalidCardNumber(NoSuchNumber)
无效卡号
15
NoSuchIssuer
无此发卡方
19
Re-enterTransaction
重新送入交易
20
InvalidResponse
无效应答
21
NoActionTaken
不
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 金融 POS 收银机 标准 函数 接口 说明 windows 版本
![提示](https://static.bdocx.com/images/bang_tan.gif)