Skip to main content
onTransferData 是用于 Marshall “Transfer Data” 命令的函数,该命令允许与交易相关的信息双向发送——通常是从设备(VPOS Touch / VPOS Media)端发送到外围设备,但也可以从外围设备发送到设备。 在 void onTransferData(byte[] data) 函数中，数据遵循 TLV（Tag-Length-Value，标签-长度-值）格式，其组成部分为：
  • 标签（1 个字节）：标识数据的类型。
  • 长度（1 个字节）：指定值的长度。
  • 值（N 字节）：包含实际数据。
传输的数据可以是一个或多个 TLV 结构，具体取决于所交换的信息。

​
例子

如果 onTransferData(byte\[] data) 接收到以下字节：
  • 5 是 Card BIN 的标签
  • 6 是长度，在本例中为 6 字节。
  • 345678 是卡号前6位数字的值。
系统提取的 Card BIN 为 “345678”。

​
标签描述

下表描述了可以使用此功能传输的不同类型的数据：
标签标签名称数据大小描述
1交易 ID8字节交易的唯一标识符。
2“Choose Product” 超时2个字节“Choose Product” 提示的超时时间。
3卡类型1字节识别所用卡的类型。详情见下文。
4卡片输入模式1字节识别卡片的输入方式（刷卡、轻触、插入等）。详情见下文。
5卡片箱6个字节卡号的前 6 位数字（ASCII）。
6卡 PAN 哈希20字节整个卡片 PAN 的 SHA1 哈希值（用于保护卡片数据）。
7专有卡UIDMiFare卡：4、7或10字节；磁条卡：最大40字节；二维码：最大255字节专用卡的唯一标识符。二维码仅包含数字。
8VMC 授权状态1字节授权结果（0 = 批准，1 = 拒绝）。
9COM状态1字节服务器与设备之间的通信状态。
10超光速数据最多 500 字节原始数据在较低级别（MDB 级别 3）传输。
11创建布局4个字节布局创建请求。
12更新布局最多 500 字节使用 ExtraData 字段更新现有布局。
13信用卡后四位数字4 个字节 (ASCII)信用卡号的后四位数字（ASCII 码）。
14产品代码2个字节识别所购买产品的代码。
15产品价格4个字节产品的价格。
16定制数据/通用最多 500 字节JSON 格式的自定义数据（具体细节有待确定）。
17消费者 ID最多 500 字节唯一消费者标识符（例如，护照号码、身份证号码）。ASCII 字符串。
18主软件版本14字节设备上运行的 Main 软件版本。
19POS软件版本10字节设备上运行的 POS 软件版本。
20违约信用2个字节Nayax Core中预设的信用额度。
21Monyx ID9字节与 Nayax Core 中定义的 Monyx 支付系统相关的 ID。
22最终价格4个字节折扣后的最终成交价格。
23卡子类型1字节更详细的卡片类型分类。详情请见下文。
24卡余额4个字节该信用卡上的剩余余额。
25Transfer to BLEN 字节数据将通过蓝牙/BLE传输。与Nayax EV相关（Nayax内部请求）。
26选择品牌8字节*仅适用于日本市场！*外设->设备：选择要付款的品牌，无需事先显示品牌选择界面。设备 > 外设：配对过程完成后，更新已配置品牌的 64 位位域中的外设。
27专有卡名称N（最多 500）字节来自 Nayax 服务器 tag 239 的专有卡片描述
28站点 ID1 字节从 Nayax 服务器返回的 Site ID 信息,包含在授权响应中
按卡类型划分的数据传输格式：
信用卡专用卡
Tag 3:Card Type(取值范围 “2”-“6”)
标签 4：进入模式
Tag 5:Card BIN
标签 6：卡片 PAN 哈希
标签 13：信用卡后四位数字
标签 1：交易 ID
标签 9：COM 状态		Tag 3:Card Type(取值为 “1”)
Tag 4:Entry Mode(Magstripe 时为 “1”, MiFare 时为 “4”,HID 时为 “5”,QR 时为 “10”)
标签 7：专有卡 UID
标签 1：交易 ID
标签 9：COM 状态
卡片类型：
刷卡模式：
卡片子类型：