POS机相关配置与说明

POS机指令说明
收单机构标识
Json菜单配置格式
出库获取终端映射配置
收单cardPayment交易特殊逻辑

POS机指令说明

00 服务端下发打印文本譬如 00|支付渠道:支付宝当面付|
01 仅显示的信息

02 输入文本数据，最大30个字节的数据

|02|01|请输入原交易日期

|02|02|请输入原交易参考号

|02|03|请输入原交易流水号

03 输入文本数据，星号回显，最大30个字节的数据
04 支持刷卡以及IC插卡，同时上送卡号，有效期，1/2/3磁道
05 二维码扫描（最长255）
06 显示提示信息，产生随机数，本地记录，然后通信，通信成功后，提示输入密文，和本地存贮随机数进行验证。验证的次数由主机返回
07 提示选择是否的确认取消，确认则继续下一步，取消则退出
08 显示选择项，按照选择的选项更新交易码。格式如下：交易码~菜单名称&交易码~菜单名称
09 首先显示提示信息，提示密文输入，星号回显，需要对密码进行非对称RSA加密
0A|00|请输入结算金额表示结算金额框 0A|02|请输入积分金额$defaultAmount 表示积分抵扣金额($defaultAmount表示初始显示0A|00的输入金额)
0B 输入银行卡密码（X9.8算法加密）
0C 读行业磁条卡(支持手输，卡号长度不限制，无有效期，上传三个磁道)
0D 只上送银行卡卡号及有效期，不上送磁道，加密(3DES)卡号在第2域，有效期在14域
0E 只上送SHA1加密的卡号，加密数据在63域40字节ASCII码，跟其他数据用|分割
0F 上送SHA1加密的卡号和卡号前六位，加密数据在63域46字节ASCII码，跟其他数据用|分割
10 确认上次输入的内容，提示语模板为：请确认输入的金额data是否正确? 显示确认与取消两个按钮，确认按钮继续下一步输入，如无，则直接交易，取消按钮则返回上一步输入位置，由操作人员清除后重新输入
11 支持银行非接IC卡读取、是否有卡号、有效期、磁道或其他数据？
12 支持行业非接IC卡读取，是否磁道或其他数据？
13 清空流水及冲正
14 重打印上笔交易
15 退出签到状态，重新签到
1F 服务端下发小票title信息譬如 'e-Buy 电子凭证'
2F 服务端下发小票交易类型信息譬如 '交易类型:二维码支付'

ps:

离线隔日退款交易action=refund，菜单需配置05指令来获取traceNo值。

收单机构标识

下发POS的标识值	易百终端标识值	收单机构	AppName	二进制位置
0x01	1	招行积分（星巴克）	cmbPoint	0000 0001
0x02	2	中信收单（透传）	citicCashpay	0000 0010
0x04	4	嘉联收单	jlpayCashpay	0000 0100
0x08	8	建行收单（间连）	ccbCashpay	0000 1000
0x10	16	建行收单（直连）	ccbCashpay	0001 0000
0x20	32	中信收单	citicCashpay	0010 0000
0x40	64	杉德收单	sandCashpay	0100 0000
0x80	128	杉德预付费	sandPrepay	1000 0000

Json菜单配置格式

菜单内容

[{
    "iconUrl": "1级菜单icon url",
    "title": "1级菜单名称",
    "action": "",
    "command": "",
    "childrenFunc": [{
        "iconUrl": "2级菜单icon url",
        "title": "2级菜单名称",
        "action": "2级菜单action",
        "command": "2级菜单下发指令"
    },
    {
        "iconUrl": "2级菜单icon url",
        "title": "2级菜单名称",
        "action": "2级菜单action",
        "command": "2级菜单下发指令",
        "platformUrls": [{
            "code": "平台code",
            "url": "平台icon url"
        }]
    }]
}]

额外信息内容（仅webposp使用）

//headPictureList    头部banner轮播图列表

{
    "headPictureList": [{
        "picUrl": "https://timgsa.baidu.com/timg?image&quality=80&size=b9999\_10000&sec=1530714400246&di=9b2f72ab52a845dfacf6526a1e1babe5&imgtype=0&src=http%3A%2F%2Fimg02.tooopen.com%2Fimages%2F20160514%2Ftooopen\_sy\_162520087466.jpg",
        "linkUrl": "http://www.e-buychina.com/"
    },
    {
        "picUrl": "图片url",
        "linkUrl": "点击图片链接url"
    }]
}

打印模板内容（仅posp使用）

#TLV格式
01=积分方式:后台折算
02=销售金额:
03=折抵金额:
04=实付金额:
05=消费积分:
06=订单号码:
07=兑换产品:
08=现场兑换,离柜无效
09=--------------------------------
0A=总计      
0B=[电子凭证]          数量
0C=[积分兑换] 笔数     金额
0D=[身份验证]          数量
0E=交通银行  
0F=招商银行

出库获取终端映射配置

接口用途

机器出库时，通过机器号获取终端映射（brand，shopNo，deviceNo）
请在出库前确保已配置好商户，终端，终端映射以及终端中的序列号。

接口地址

https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/ebuyGetPosConfig

action

ebuyGetPosConfig

请求参数，中间件===>易百后台

字段	类型	是否必填	字段意义	备注
posSn	String	否	机器序列号	例如：G8703U12345

请求报文举例

  {
    "posSn": "G8703W00519"
  }

返回参数，易百后台===>中间件

字段	类型	是否必填	字段意义	备注
returnCode	String	是	返回码	00表示交易成功，其他表示失败
returnDesc	String	是	返回信息	交易结果描述或错误原因
deviceNo	String	否	收银机编号
shopNo	String	否	门店编号
brand	String	是	品牌编号	如：674

返回报文举例

{
    "returnCode": "00",
    "shopNo": "16171",
    "deviceNo": "1",
    "brand": "674",
    "returnDesc": "SUCCESS"
}

返回码表

"00" , "SUCCESS"

"GRT_CONFIG_ERROR01", "POS_SN NOT EXIST"

"GRT_CONFIG_ERROR02", "POS_SN USED BY MULTI-TERMINAL"

"GRT_CONFIG_ERROR03", "TERMINAL IS MISSING"

"GRT_CONFIG_ERROR04", "POS CONFIG NOT EXIST"

"GRT_CONFIG_ERROR05", "POS CONFIG IS WRONG"

收单cardPayment交易特殊逻辑

正交易：

仅当action=cardPayment时，中间件不唤醒刷卡界面，直接组装报文请求易百后台，等待二次交互或收单指令返回。

刷卡输密由子应用发起。

反交易（当action=void或action=refund）：

当acquirer字段不为空时，中间件不唤醒刷卡界面，直接组装报文请求易百后台，等待收单指令返回。

刷卡输密由子应用发起。