概述

本文档是介绍家易通mPOS终端交易接口和交易流程的技术文档。

基础协议部分

1.符号定义

本规范使用以下标识符来说明数据元的属性：

(1).一般描述

(2).长度属性

(3).数据元值

BCD 表示该字段采用BCD码表示，即每四比特位表示一数据位
BIN 二进制数据，长度按比特位表示
ASCII 一般字符字段，长度按字节计

(4).域属性

M表示该数据元必须存在，为强制性数据元 ,O表示该数据元是可选性的,
C 表示数据元是条件性的

2.数据包定义

2.1.外层报文

2.2.内层报文

2.2.1.参数

参数采用TLV形式，传递终端厂商编码，终端程序版本号等信息。

2.2.2.交易数据报文

8583报文。

3.交易数据包格式

3.1.签到

3.2.查询

3.3.消费

48域打印信息样例：
S10104is:22浦发银行|ac:交通银行|card_type:借记卡|TC:9F2608203EEAC705CBF3D1|AID:8408A0000003330101010166{“is”:”22浦发银行”,”ac”:”交通银行”,”card_type”:”借记卡”,”TC”:”9F2608203EEAC705CBF3D1”,”AID”:”8408A000000333010101”}

3.4.1.卡卡转账(确认)

说明1：

3.4.2.卡卡转账(交易)

说明1：

3.5.1.卡企转账(确认)

说明1：

3.5.2.卡企转账(交易)

说明1：

3.6.1超级网银转账（确认）

说明1：

3.6.2超级网银转账（交易）

说明1：

3.7.1.二代支付转账（确认）

说明1：

3.7.2.二代支付转账（交易）

说明1：

3.8.交易证书(TC)上送

3.9.交易信息(AAC)上送

3.10.脚本通知上送

3.11.末笔补打

说明1：

L代表前一个参数位置

3.12.当日明细查询

说明1：

3.13.历史明细查询

说明1：

L代表前一个参数位置

请求：

返回：

3.14.更新公钥

说明1：

1． 签到交易

image

2.更新公钥交易
连续发送更新公钥交易，POS每次需上送当前POS公钥版本号（35域）， 主机返回更新后的版本号（35域），以及后续标志（28域）。

image

当签到交易28域返回‘04’时，需同时发起更新公钥和更新参数交易。
说明2：终端更新公钥前，须先清空当前公钥。

3.15.更新IC交易参数

说明1：
1． 签到交易

image

2． 更新参数交易
  连续发送更新参数交易，POS每次需上送当前POS版本号（35域）， 主机返回更新后的版本号（35域，最后一次返回版本号‘00’）， 以及后续标志（28域）。

image

当签到交易28域返回‘04’时，需同时发起更新公钥和更新参数交易。
说明2：终端更新参数前，须先清空当前参数。

3.16.通用交易

说明1：
此处为附加域信息，由电银APK传入MPos端无需处理直接打包，而返回报文中如果由48域信息，Mpos也无需处理直接返回电银APK。
当8583中“信息类型”为“0900”时，标示这笔8583为通用交易，48域需要重需要上送两类信息且此类信息都为LV格式：

例子1：
（例如：手机号:13805187832|卡号:655232355655435543|） 
例子2
（例如：{ "mobile_tel":"13805187832", "card_in":"655232355655435543"}）
说明2：
如果终端为刷卡或者插卡形式，Pan的获取以刷卡或插卡获得的卡号计算pan。如果以“说明4”中获得的输入卡号为基础，则以输入卡号计算pan。当两者都存在时，以刷卡或插卡获得的pan为准。如果当两者都不存在，且还有输入密码的流程时，MPos直接返回错误。
说明3：
电银APK和厂商APK间需要增加动态“处理代码”的输入，Mpos当交易类型为通用交易请以电银APK传送的动态“处理代码”填入8583域中第3域值。（例：100000，则Mpos8583域中信息类型为0900，处理代码为100000）
说明4：
电银APK和厂商APK间需要增加输入卡号的接口，输入的卡号需要放入“说明1”中的确认域和交易信息域中
说明5：
电银APK和厂商APK间需要增加交易流程接口，输入项为“getcard”,”getpin”两种指令，“getcard”代表调用Mpos进行刷卡或者插卡动作，”getpin”代表调用Mpos进行让用户输入交易密码动作。当需要结合俩动作指令时，以”|”分隔，例如”getcard|getpin”，此处请注意相关顺序
说明6：
电银APK和厂商APK间需要增加交易类型的下送，例如（“缴费交易”）
注1：本“通用交易”中的有关说明中所有分隔符皆为英文，切勿使用中文

3.17.第三方支付通用交易

用法说明：
域48：
参见《云智付收单平台对外服务接口说明》

3.18.电子签名上送交易

用法说明1：
60.2域：
网络管理信息码80X（X从0到9）表明电子签字数据包附加编号，电子化凭条中800表明后续没有“部分电子签字报文”，801表明当前是签字的第一个包、后续还有“部分电子签字报文”；部分电子签字报文中取值从802起依次类推。
用法说明2：
62域：
变量属性：
ANS...900(LLLVAR)，3个字节的长度值＋最大900个字节的数据域。压缩时用右靠BCD码表示的2个字节的长度值＋用ASCII码（此处为压缩格式）表示的最大900个字节的数据。
域描述：
存放电子签字信息，格式为压缩后的签字点阵数据。

4.交易流程

4.1.签到

4.2.查询

4.3.消费

4.4.末笔补打

4.5.当日明细查询

4.6.历史明细查询

4.7.转账

5.附件

5.1.39域定义

5.2.22域定义