济南市商业银行atm接口

1、目录ATMP模块与ATMC 接口规范11.1.1.2.1.2.消息概述4ATMP接收消息格式4公共格式公共格式 消息头请求4 消息头应答5TTI6OEX7RWT7CWD7CWC8INQ8PIN9TFW9CDP101.3.ATMP发送消息(送往ATMC)11A11C11Q or W11R11S12D12T. 12U12V12P121.4.1.5.1.6.1.7.附录1：关于OEX状态的说明：13附录2：关于金额格式的说明：13附录3：关于格式的说明：13附录3：应答码：131.1. 消息概述以下是 ATMC 和 ATMP 之间的消息，ATMP 对于每一个 ATMC 发送来的消息，根据处理情况返回

2、一种消息。下表中，每一行左边是是 ATMP 可能的多个返回消息。另有一些由于未通过 发送的消息列在下表最后一项。ATMC发送的指令，右边而由 ATMP 向 ATMC1.2. ATMP 接收消息格式1. 公共格式 消息头请求ATMC-ATMPATMP-ATMCTTI:ATMC 请求核对 ATMCTOTALSAAP: OK( 如 果ATMPTotals与ATMCTotals 相同)ACP:ATMPTotals(如果不同)RWT:ATM 钱箱设置AAP: OK(如果 ATMPTotals 与送上来的信息相同):不同时或失败时OEX:设备状态AAP:OKCWD:现金提取AQP:允许提取现金AUP:余额

3、CWC:恢复现金提取AWP:成功恢复现金提取INQ:帐户查询ARP:查询结果PIN:修改ASP:成功TFW:转账AQP:转账成功AUP:余额CDP:现金实时存款AQP:实时存款成功四字节（字符串 N）N 字节消息长度报文例如整个消息包长度为 256 个字节（不包括长度域），则长度域为“0256”每个消息包中包含整个包的长度信息，消息包长度将以 4 个 BYTE 的字符格式提供。整个消息包的格式如下：起首 4 个字节作为一个字符串，指明消息内容的长度（不包含上述的 4 个字节）；紧接着便是报文。2. 公共格式 消息头应答序号长度类型内容公用补充1,2,33ATFC+TPC+操作模式*44A响应码

4、56NATMC 流水号与请求消息中的一致64NATMC 终端号唯一确定一台 ATM机器76NATMP 流水号可用于凭条打印814A交易时间序号长度类型内容公用补充11A应用交易*23AATMC 交易码*31NATM 钱箱 1 状态*0: 好 1: 钱太少2: 没有钱3: 不能工作4: 没有安装41NATM 钱箱 2 状态*51NATM 钱箱 3 状态*61NATM 钱箱 4 状态*74NATM 钱箱 1 出钞数84NATM 钱箱 2 出钞数94NATM 钱箱 3 出钞数104NATM 钱箱 4 出钞数112NATM 钱箱 1 废钞数122NATM 钱箱 2 废钞数132NATM 钱箱 3 废钞

5、数142NATM 钱箱 4 废钞数151NATM 流水状态*0: 正常1:纸太少2: 没纸3:不能工作161NATM 凭单状态*171N状态*0: 正常；1:模块不能工作； 2:卡模块不能工作；3: 不能工作181N出钞模块状态*0: 正常1:未安装2: 不能工作191N实时存款模块状态*0: 正常1:未安装2: 不能工作201N加密模块状态211AATM 状态*O:打开C:关闭226NATMC 流水号2314NATMC 设备时间*YYYYMMDDhhmmss244NATMC 终端号唯一确定一台 ATM机器2516A备用现暂为空TTIATMC 请求主机对 ATMCTotals 和 ATMPTo

6、tals 进行对帐。字段描述长度类型值注释2ATM 交易码3A“TTI”24钱箱 1 的钞票面值4N25钱箱 2 的钞票面值4N26钱箱 3 的钞票面值4N27钱箱 4 的钞票面值4N28钱箱 1 加钞数4N29钱箱 2 加钞数4N30钱箱 3 加钞数4N31钱箱 4 加钞数4N32钱箱 1 吐钞数4N33钱箱 2 吐钞数4N34钱箱 3 吐钞数4N35钱箱 4 吐钞数4N36钱箱 1的钞票数4N37钱箱 2的钞票数4N38钱箱 3的钞票数4N39钱箱 4的钞票数4N40钱箱 1 入废钞箱的钞票数4N41钱箱 2 入废钞箱的钞票数4N42钱箱 3 入废钞箱的钞票数4N43钱箱 4 入废钞箱的钞

7、票数4N44钱箱 1 的钞票币种3N156-RMB45钱箱 2 的钞票币种3N46钱箱 3 的钞票币种3N47钱箱 4 的钞票币种3N48吞卡2N49取款次数4N50取款金额12N9(7)V9953存款次数4N54存款总额12N9(7)V9955转帐总次数4N56转帐总金额12N9(7)V9957MAC16A91A卡识别标志1- 主 机 卡 表 数据变化， 需 ATMC0 不需 ATMC 下载101A是否允许转帐1 不允许0 正常111A是否吞卡1 吞卡0 正常1216A备用暂为空OEXATMC 向主机状态。RWTATM 钱箱设置后通知前置机，钞箱状态按交易设置，交易累计清零。RQKATM 钱

8、箱设置后通知前置机，钞箱状态按交易设置，交易累计清零。CWD提取现金。字段描述长度类型值注释2ATM 交易码3A“CWD”24ATM 卡第二磁道长度2N2 位，左补零,无 2 磁， 填全025ATM 卡第二磁道37A无 2 磁， 填全0，右补零26ATM 卡第三磁道长度3N3 位，左补零无 3 磁， 填全027ATM 卡第三磁道104A无 3 磁， 填字段描述长度类型值注释2ATM 交易码3A“RQK”*24MAC16A字段描述长度类型值注释2ATM 交易码3A“RWT”*24钱箱 1 的钞票面值4N*25钱箱 2 的钞票面值4N*26钱箱 3 的钞票面值4N*27钱箱 4 的钞票面值4N*2

9、8这次向钱箱 1 加钞的4N*29这次向钱箱 2 加钞的4N*30这次向钱箱 3 加钞的4N*31这次向钱箱 4 加钞的4N*48钱箱 1 的钞票币种3N156-RMB49钱箱 2 的钞票币种3N50钱箱 3 的钞票币种3N51钱箱 4 的钞票币种3N52MAC16A字段描述长度类型值注释2ATM 交易码3A“OEX”24例外原因代码4A“2037”CWC恢复现金提取。INQ帐户查询。字段描述长度类型值注释2ATM 交易码3A“INQ”24ATM 卡第二磁道长度2N2 位，左补零,无 2 磁， 填全0字段描述长度类型值注释2ATM 交易码3A“CWC”24ATM 卡第二磁道长度2N2 位，左补

10、零,无 2 磁， 填全025ATM 卡第二磁道37A无 2 磁， 填全0，右补零26ATM 卡第三磁道长度3N3 位，左补零无 3 磁， 填全027ATM 卡第三磁道104A无 3 磁， 填全0，右补零28输入长度1N4 或 6 位298A30长度2N3119A32帐户序号2N现在填全0033发生额12A9(7)V99左补 034币种3N156-RMB35原始流水号6N37取消原因代码4N38MAC16A全0，右补零28输入长度1N4 或 6 位298A30长度2N3119A19 位右补空格32帐户序号2N现在填全0033发生额12N9(7)V99左补 034币种3N156-RMB35MAC1

11、6APIN修改。TFWATM 本地转帐。字段描述长类值注释字段描述长度类型值注释2ATM 交易码3A“PIN”24ATM 卡第二磁道长度2N2 位，左补零,无 2 磁， 填全025ATM 卡第二磁道37A无 2 磁， 填全0，右补零26ATM 卡第三磁道长度3N3 位，左补零无 3 磁， 填全027ATM 卡第三磁道104A无 3 磁， 填全0，右补零28长度1298A30长度2N3119A32新长度133新8A34MAC16A25ATM 卡第二磁道37A无 2 磁， 填全0，右补零26ATM 卡第三磁道长度3N3 位，左补零无 3 磁， 填全027ATM 卡第三磁道104A无 3 磁， 填全

12、0，右补零28输入长度1N4 或 6 位298A30长度2N3119A32帐户序号2N现在填全 0033币种3N156-RMB34MAC16ACDP现 金 实 时 储 蓄字段描 述长度类型值注 释2ATM 交 易 码3A“CDP”存款24ATM 卡第二磁道长度2N2 位，左补零,无 2 磁， 填全025ATM 卡第二磁道37A无 2 磁， 填全0，右补零26ATM 卡第三磁道长度3N3 位，左补零无 3 磁， 填全027ATM 卡第三磁道104A无 3 磁， 填全0，右补零28持卡人长度1N4 位或 6 位度型2ATM 交易码3ATFW-转出可扩充24ATM 卡第二磁道长度2N2 位，左补零,

13、无 2 磁， 填全025ATM 卡第二磁道37A无 2 磁， 填全0，右补零26ATM 卡第三磁道长度3N3 位，左补零无 3 磁， 填全027ATM 卡第三磁道104A无 3 磁， 填全0，右补零28持卡人长度1N4 或 6 位29持卡人8A30持卡人长度2N2 位，左补零31持卡人19A32持卡人帐户序号2N现在填全 0033发生额12A9(7)V99左补 034币种3N156-RMB35对方出/受款帐号长度2N36对方出/受款帐号19A37MAC16A1.3. ATMP 发送消息(送往 ATMC)A对 TTI，RWT(当 ATMC Totals 与 ATMP Totals 匹配时)，AE

14、X，OEX 的回答。C当 ATMCTotals 与 ATMPTotals 不匹配时对 TTI 的响应。Q or W对 CWD，CWC, CDP 接收的响应。字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”AQP”AWP”Q: CWD,CDP,CDR W: CWC字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”ACP”13钱箱 1 钞票面值4N14钱箱 2 钞票面值4N15钱箱 3 钞票面值4N16钱箱 4 钞票面值4N17钱箱 1 剩下钞票数4N18钱箱 2 剩下钞票数4N19钱箱 3 剩下钞票数4N20钱箱 4 剩下钞票数4N21钱箱 1 吐钞4N22钱箱 2 吐

15、钞4N23钱箱 3 吐钞4N24钱箱 4 吐钞4N25吞卡2N26取款次数4N27取款金额12N9(7)V9928存款次数4N29存款总额12N9(7)V9930转帐次数4N31转帐总额12N9(7)V99字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”AAP”13交易日期14AYYYYMMDDHHMMSS29持卡人8A28长度2N2 位，左补零2919A30帐户序号2N现在填全 0031发 生 额12A9(6)V99左补 032币 种3N156RMB33MAC16AR对 INQ 的接收回答。S对 PIN 接收的响应。D对 RWT 的响应。T对 CWD，CWC, INQ，PFW

16、的响应。U由于帐户余额或可提取金额而对 CWD 的响应。V要求 ATM 重发原始信息并重设通信基码响应。字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”AVP”13新密钥8A字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”AUP”字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”ATP”AGP”G 仅用于不同步的 TK，其 码 3001不加密字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”ASP”13交易长度2N2 位，左补零14交易19A字段描述长度类型值注释1,2,3TFC+

17、TPC+操作模式3A”ARP”13交易长度2N2 位，左补零14交易19A15帐户余额12A9(9)V9916帐户可用余额12A9(9)V9917ATM 可提取金额12A9(9)V9913交易长度2N2 位，左补零14交易19A15发生额12A9(7)V9916手续费12N9(7)V99P对 OEX 的回答。对 RQK 的回答。1.4.附录 1：关于 OEX 状态的说明：ATMC 端在没有交易发生的时候，每隔一定时间（可参数设置，每次 RPT 时由主机返回该值，ATMC 端设置，并立即生效）向主机发送该状态报文， 如果主机在规定时间收到该报文，认为该台 ATM出现故障。ATMC 在上笔交易完成

18、时开始计时。附录 2：关于金额格式的说明：1.5.金额位数时，左补 01.6.附录 3：关于格式的说明：位数时，右补空格1.7.附录 4：关于前补两位运算。加密的说明：长度，右补F，补足 16 位，后与 PINKEY 作 DES1.8.附录 5：关于产生 MAC 的说明：使用标准 MAC 算法产生数据包的 MAC。1.9.附录 6：应答码：CodeResponse DescriptionAction含义00010203Approvedorcompleted sucsfullyRefer to card ierRefer to card iers spel conditionInvalid me

19、rchantApprov e Declin e-承兑或交易成功查发卡方查发卡方的特殊条件无效商户字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”ABP”13PINKEY 的密文16A14MACKEY 的密文16A字段描述长度类型值注释1,2,3TFC+TPC+操作模式3A”APP”13间隔秒数4ACode 0405060709121314151920212223253031333435363738Response Description Pick-upDo not honorErrorPick-up card, spel conditionRequest in progress

20、Invalid tran ion Invalid amountInvalid card number (no such number)No such i erRe-enter tranionInvalid response No action takened malfunction Unacceptable tranion feeUnable to locate record on file Format errorB not supported by switchExpired carded fraudCard acceptor contact securityRestricted card

21、Cardacceptorcallacquirer securityAllowablN tries exceededAction Pick-u p Declin e-Pick-u p-Declin e Declin e Declin e-Declin e-Declin ePick-u pPick-u pPick-u pPick-u pPick-u pPick-u p含义没收卡不予承兑出错特殊条件下没收卡请求正在处理中无效交易无效金额无效无此发卡方重新送入交易无效应答不作任何处理怀疑操作有误不可接受的交易费未能找到文件上格式错误交换中心不支持的过期的卡（没收卡）有嫌疑（没收卡）受卡方与安全部门联系

22、（没收卡）受限制的卡（没收卡）受卡方呼受理方安全部门（ 没收卡） 超过允许的 PIN 试输入（没收卡）Code 3940414243445152535455565758596061626364Response Description No credit accountRequested function not supportedLost cardNo universal accountStolen card, pick-upNo investment accountNot sufficient fundsNo chequing accountNo saving accountExpired

23、cardIncorrectalidentification number No card recordTranion not permitted to cardholderTranion not permitted to terminaled fraudCard acceptor contact acquirerExceeds withdrawal amount limitRestricted cardSecurity violation Original amount incorrectAction Declin e Declin ePick-u p Declin ePick-u p Declin e Declin e Declin e Declin e Declin e Declin e-Declin e Declin e Declin e Declin e Declin e Declin e-Declin e含义无此帐户请求的功能尚不支持挂失卡（没收卡）无此帐户被窃卡（没收卡）无此投资帐户无足够的存款无此支票帐户无此储蓄卡帐户过期的卡不正确的 PIN无此卡不允许持卡人进行的交易不允许终端进行