# 业务参数对象



# 卡信息

- JSON Key为cardInfo，出现在请求报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>cardNo</td><td>String</td><td>是</td><td>卡号</td><td>卡支付类交易时为必填</td></tr><tr><td>password</td><td>String</td><td>否</td><td>密码</td><td>如需要密码时必填，采用金融加密</td></tr><tr><td>valid</td><td>String</td><td>否</td><td>有效期</td><td>卡支付类交易时为必填，格式：YYMM</td></tr><tr><td>track1</td><td>String</td><td>否</td><td>第一磁道</td><td>采用金融加密</td></tr><tr><td>track2</td><td>String</td><td>否</td><td>第二磁道</td><td>卡支付类交易时为必填，采用金融加密</td></tr><tr><td>track3</td><td>String</td><td>否</td><td>第三磁道</td><td>采用金融加密</td></tr><tr><td>cardSn</td><td>String</td><td>否</td><td>IC卡序列号</td><td>卡支付类交易时，如为IC卡则必填</td></tr><tr><td>icData</td><td>String</td><td>否</td><td>IC卡数据</td><td>卡支付类交易时，如为IC卡则必填</td></tr><tr><td>cardType</td><td>String</td><td>否</td><td>卡类型</td><td>具体枚举如下</td></tr><tr><td>tc</td><td>String</td><td>否</td><td>交易证书</td><td>用于确认交易符合相应规则的证书</td></tr></tbody></table>

#### **cardNo加密方法**

- 使用pinKey对cardNo进行3DES加密，加密结果转为HEX格式，详见：[数据加密算法](https://book.e-buy.com/link/108#bkmrk-page-title "数据加密算法")

#### **password加密方法**

- 使用对pinKey进行ANSI X.98加密，加密结果转为HEX格式，详见：[密码加密算法](https://book.e-buy.com/link/109#bkmrk-page-title "密码加密算法")

#### **track1加密方法**

- 使用pinKey对track1进行3DES加密，加密结果转为HEX格式，详见：[数据加密算法](https://book.e-buy.com/link/108#bkmrk-page-title "数据加密算法")

#### **track2加密方法**

- 使用pinKey对track2进行3DES加密，加密结果转为HEX格式，详见：[数据加密算法](https://book.e-buy.com/link/108#bkmrk-page-title "数据加密算法")

#### **track3加密方法**

- 使用pinKey对track3进行3DES加密，加密结果转为HEX格式，详见：[数据加密算法](https://book.e-buy.com/link/108#bkmrk-page-title "数据加密算法")

#### **cardType枚举**

00表示刷磁条卡

01表示插入IC卡

02表示非接IC卡

03表示手输卡号

04表示二维码扫描

05表示其他

06表示收银机采集数据

07表示ApplePay

08表示三星Pay

09表示华为Pay

10表示小米Pay

# 礼品卡信息

- JSON Key为cardInfo，出现在返回报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c" style="width: 91.5476%;"><thead><tr><th style="width: 19.2708%;">字段</th><th style="width: 12.6272%;">类型</th><th style="width: 14.977%;">是否必填</th><th style="width: 34.5052%;">字段意义</th><th style="width: 18.75%;">备注</th></tr></thead><tbody><tr><td style="width: 19.2708%;">cardNo</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">卡号</td><td style="width: 18.75%;">礼品卡号</td></tr><tr><td style="width: 19.2708%;">cardStatus</td><td style="width: 12.6272%;">int</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">卡状态</td><td style="width: 18.75%;">  
</td></tr><tr><td style="width: 19.2708%;">effectStartTime</td><td style="width: 12.6272%;">long</td><td style="width: 14.977%;">否</td><td style="width: 34.5052%;">有效开始时间</td><td style="width: 18.75%;">时间戳（毫秒数）</td></tr><tr><td style="width: 19.2708%;">expireTime</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">否</td><td style="width: 34.5052%;">失效时间</td><td style="width: 18.75%;">时间戳（毫秒数）</td></tr><tr><td style="width: 19.2708%;">bindSuccessTime</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">否</td><td style="width: 34.5052%;">绑定成功时间</td><td style="width: 18.75%;">时间戳（毫秒数）</td></tr><tr><td style="width: 19.2708%;">lastUseTime</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">否</td><td style="width: 34.5052%;">最近使用时间</td><td style="width: 18.75%;">时间戳（毫秒数）</td></tr><tr><td style="width: 19.2708%;">cardId</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">礼品卡种ID</td><td style="width: 18.75%;">  
</td></tr><tr><td style="width: 19.2708%;">cardName</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">礼品卡名称</td><td style="width: 18.75%;">  
</td></tr><tr><td style="width: 19.2708%;">cardFaceValue</td><td style="width: 12.6272%;">Price</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">卡面值（单位：元，保留两位小数）</td><td style="width: 18.75%;">后端返回</td></tr><tr><td style="width: 19.2708%;">cardNetValue</td><td style="width: 12.6272%;">Price</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">卡净值（单位：元，保留两位小数）</td><td style="width: 18.75%;">后端返回</td></tr><tr><td style="width: 19.2708%;">cardBalance</td><td style="width: 12.6272%;">Price</td><td style="width: 14.977%;">是</td><td style="width: 34.5052%;">卡余额（单位：元，保留两位小数）</td><td style="width: 18.75%;">后端返回</td></tr><tr><td style="width: 19.2708%;">extraInfo</td><td style="width: 12.6272%;">String</td><td style="width: 14.977%;">否</td><td style="width: 34.5052%;">附加信息</td><td style="width: 18.75%;">主要是针对显示用的</td></tr></tbody></table>

- 卡状态枚举说明

<table border="1" id="bkmrk-%E7%8A%B6%E6%80%81%E5%80%BC-%E7%8A%B6%E6%80%81%E5%90%8D%E7%A7%B0-0-%E5%B7%B2%E7%94%A8%E5%AE%8C-11-%E5%8F%AF%E4%BD%BF" style="border-collapse: collapse; width: 24.2857%; height: 209.375px;"><colgroup><col style="width: 31.998%;"></col><col style="width: 68.002%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-right" style="height: 29.7969px;">状态值</td><td style="height: 29.7969px;">状态名称</td></tr><tr style="height: 29.7969px;"><td class="align-right" style="height: 29.7969px;">0</td><td style="height: 29.7969px;">已用完</td></tr><tr style="height: 29.7969px;"><td class="align-right" style="height: 29.7969px;">11</td><td style="height: 29.7969px;">可使用</td></tr><tr style="height: 29.7969px;"><td class="align-right" style="height: 29.7969px;">20</td><td style="height: 29.7969px;">已过期</td></tr><tr style="height: 29.7969px;"><td class="align-right" style="height: 29.7969px;">21</td><td style="height: 29.7969px;">已作废</td></tr><tr style="height: 30.5938px;"><td class="align-right" style="height: 30.5938px;">81</td><td style="height: 30.5938px;">已经激活未绑定</td></tr><tr style="height: 29.7969px;"><td class="align-right" style="height: 29.7969px;">82</td><td style="height: 29.7969px;">未激活</td></tr></tbody></table>

# New Page



# 产品明细

- JSON Key为`goodsDetail`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-g"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>goodsCategory</td><td>String</td><td>是</td><td>商品类别</td><td> </td></tr><tr><td>goodsId</td><td>String</td><td>是</td><td>商品编号</td><td> </td></tr><tr><td>goodsName</td><td>String</td><td>是</td><td>商品名称</td><td>用于报表、小票等显示</td></tr><tr><td>goodsSpec</td><td>String</td><td>否</td><td>商品规格</td><td>用于报表、小票等显示</td></tr><tr><td>price</td><td>Price</td><td>是</td><td>单价</td><td>单位：元</td></tr><tr><td>quantity</td><td>Integer</td><td>是</td><td>数量</td><td> </td></tr><tr><td>rebateCode</td><td>String</td><td>否</td><td>折扣代码</td><td>收银机上已设置折扣，则必填,长度大于3位小于32位</td></tr><tr><td>activityNo</td><td>String</td><td>否</td><td>活动编号</td><td>易百后台交易成功，会返回本交易所属的活动编号</td></tr><tr><td>memo</td><td>String</td><td>否</td><td>备注</td><td>易百后台交易成功，会返回部分信息，如电子凭证号码</td></tr><tr><td>voucherId</td><td>String</td><td>否</td><td>优惠券ID</td><td>当有优惠券信息时返回</td></tr></tbody></table>

# 资金渠道

- JSON Key为`fundChannel`，出现在返回报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>channelNo</td><td>String</td><td>是</td><td>资金渠道编号</td><td>  
</td></tr><tr><td>channelName</td><td>String</td><td>是</td><td>资金渠道名称</td><td>  
</td></tr><tr><td>channelAmount</td><td>Price</td><td>是</td><td>金额</td><td>对应的资金渠道金额</td></tr><tr><td>sectionNo</td><td>String</td><td>否</td><td>活动编号</td><td>活动编号由财务后台分配，和收银机可以进行匹配入机</td></tr></tbody></table>

- 支持的资金渠道如下：

<table id="bkmrk-channelno-channelnam" style="width: 565px;"><thead><tr><th style="width: 125px;">channelNo</th><th style="width: 115px;">channelName</th><th style="width: 325px;">字段意义</th></tr></thead><tbody><tr><td style="width: 125px;">user\_real\_money</td><td style="width: 115px;">用户实际支付</td><td style="width: 325px;">如支付宝余额、余额宝、微信钱包余额、银行卡等</td></tr><tr><td style="width: 125px;">user\_balance</td><td style="width: 115px;">用户余额支付</td><td style="width: 325px;">如支付宝余额、余额宝、微信钱包余额等</td></tr><tr><td style="width: 125px;">user\_bank\_card</td><td style="width: 115px;">用户银行卡余额</td><td style="width: 325px;">使用用户借记卡或贷记卡的余额进行支付</td></tr><tr><td style="width: 125px;">user\_credit</td><td style="width: 115px;">用户信用支付</td><td style="width: 325px;">如绑卡活动、支付宝花呗、京东白条等</td></tr><tr><td style="width: 125px;">user\_points</td><td style="width: 115px;">用户积分支付</td><td style="width: 325px;">如银行积分、天猫积分、集分宝等</td></tr><tr><td style="width: 125px;">user\_points\_amount</td><td style="width: 115px;">用户积分对等的金额(RMB)</td><td style="width: 325px;">用户本次支付的积分值除以积分比例得到金额</td></tr><tr><td style="width: 125px;">user\_rights</td><td style="width: 115px;">用户权益</td><td style="width: 325px;">商户权益等</td></tr><tr><td style="width: 125px;">user\_coupon</td><td style="width: 115px;">用户用券抵扣金额</td><td style="width: 325px;">如支付宝卡包券、银行APP卡包券(等于<span lang="EN-US">voucherDetail</span>明细中的所有<span lang="EN-US">voucherAmount</span>累加总和)</td></tr><tr><td style="width: 125px;">merchant\_benefit</td><td style="width: 115px;">商户提供的优惠</td><td style="width: 325px;">如商户空券，商户折扣等</td></tr><tr><td style="width: 125px;">platform\_benefit</td><td style="width: 115px;">平台提供的优惠</td><td style="width: 325px;">如平台折扣，平台补贴等</td></tr><tr><td style="width: 125px;">other\_benefit</td><td style="width: 115px;">其他出资方优惠</td><td style="width: 325px;">如银行</td></tr><tr><td style="width: 125px;">ebuy\_benefit</td><td style="width: 115px;">易百提供的优惠</td><td style="width: 325px;">如易百折扣，易百补贴等</td></tr></tbody></table>

# 打印信息

- JSON Key为`printDetail`，出现在返回报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>cardNo64</td><td>String</td><td>否</td><td>卡号前六后四</td><td>返回需要打印的卡号前六后四</td></tr><tr><td>bank</td><td>String</td><td>否</td><td>发卡银行</td><td>返回需要打印的发卡银行</td></tr><tr><td>bankTid</td><td>String</td><td>否</td><td>收单终端号</td><td>在银联二维码，嘉联收单时返回</td></tr><tr><td>bankMid</td><td>String</td><td>否</td><td>收单商户号</td><td>在银联二维码，嘉联收单时返回</td></tr><tr><td>paymentOrderNo</td><td>String</td><td>否</td><td>机构订单号</td><td>返回需要打印的机构订单号</td></tr><tr><td>paymentUser</td><td>String</td><td>否</td><td>机构用户账号</td><td>返回需要打印的机构用户账号</td></tr><tr><td>pointSale</td><td>String</td><td>否</td><td>扣除积分</td><td>返回需要打印的扣除积分数量</td></tr><tr><td>qrCode1</td><td>String</td><td>否</td><td>打印二维码1</td><td>返回需要打印的二维码1</td></tr><tr><td>qrCode2</td><td>String</td><td>否</td><td>打印二维码2</td><td>返回需要打印的二维码2</td></tr><tr><td>qrCode3</td><td>String</td><td>否</td><td>打印二维码3</td><td>返回需要打印的二维码3</td></tr><tr><td>barCode1</td><td>String</td><td>否</td><td>打印条码1</td><td>返回需要打印的条码内容1</td></tr><tr><td>barCode2</td><td>String</td><td>否</td><td>打印条码2</td><td>返回需要打印的条码内容2</td></tr><tr><td>barCode3</td><td>String</td><td>否</td><td>打印条码3</td><td>返回需要打印的条码内容3</td></tr><tr><td>content</td><td>String</td><td>否</td><td>打印内容</td><td>返回需要打印的内容，[TLV](https://book.e-buy.com/link/104#bkmrk-tlv "通讯协议中常用的数据格式，由标签（Tag），长度（Length），值（Value）三部分构成")格式，1F为小票title，2F为小票交易类型说明显示</td></tr><tr><td>printMode</td><td>String</td><td>否</td><td>打印联数</td><td>1表示一联，2表示两联，3表示三联</td></tr></tbody></table>

# 会员信息

- JSON Key为`memberDetail`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-m"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>memberId</td><td>String</td><td>是</td><td>会员编号</td><td> </td></tr><tr><td>memberCode</td><td>String</td><td>是</td><td>会员卡号</td><td> </td></tr><tr><td>memberName</td><td>String</td><td>是</td><td>会员名称</td><td> </td></tr><tr><td>memberPhone</td><td>String</td><td>否</td><td>会员手机号码</td><td> </td></tr><tr><td>grade</td><td>String</td><td>否</td><td>会员等级</td><td> </td></tr><tr><td>status</td><td>String</td><td>否</td><td>会员状态</td><td> </td></tr><tr><td>balance</td><td>Price</td><td>否</td><td>会员卡余额</td><td> </td></tr><tr><td>pointBalance</td><td>Price</td><td>否</td><td>会员积分余额</td></tr></tbody></table>

# 权益信息

- JSON Key为`rightsDetail`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-s"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>snCode</td><td>String</td><td>是</td><td>权益编号</td></tr></tbody></table>

# 结算记录

- JSON Key为`settleRecord`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-a"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>activityNo</td><td>String</td><td>是</td><td>活动编号</td><td> </td></tr><tr><td>activityName</td><td>String</td><td>是</td><td>活动名称</td><td> </td></tr><tr><td>productName</td><td>String</td><td>是</td><td>产品名称</td><td> </td></tr><tr><td>customer</td><td>String</td><td>是</td><td>结算客户</td><td> </td></tr><tr><td>isRefund</td><td>Boolean</td><td>是</td><td>是否为退款</td><td> </td></tr><tr><td>volume</td><td>Integer</td><td>是</td><td>交易笔数</td><td> </td></tr><tr><td>totalReceiptAmount</td><td>Price</td><td>是</td><td>商户实收金额</td><td> </td></tr><tr><td>totalAmount</td><td>Price</td><td>是</td><td>小计金额</td></tr></tbody></table>

# 交易记录

- JSON Key为`transRecord`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>原交易收银机流水号</td><td>必须包含yyyyMMdd(当天)</td></tr><tr><td>paidAmount</td><td>String</td><td>是</td><td>支付成功金额</td><td> </td></tr><tr><td>status</td><td>String</td><td>是</td><td>匹配状态</td><td>枚举如下</td></tr></tbody></table>

**status枚举**

- 0 上送初始时填写该值
- 1 paidAmount易百后台等于上送值
- 2 paidAmount易百后台大于上送值
- 3 paidAmount易百后台小于上送值
- 4 易百后台不存在该笔交易
- 5 易百后台该笔交易为失败交易
- 6 易百后台该笔交易为已撤销交易
- 7 易百后台该笔交易为已冲正交易
- 8 易百后台该笔交易为已退款交易
- 9 易百后台对账处理失败
- 10 易百后台有，但收银机不存在该笔交易

# 活动产品

- JSON Key为`activityProductList`，只在需要二次交互时填写

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-a"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>activityProductNo</td><td>String</td><td>是</td><td>活动产品编号</td><td> </td></tr><tr><td>activityProductName</td><td>String</td><td>是</td><td>活动产品名称</td><td> </td></tr><tr><td>command</td><td>String</td><td>否</td><td>下发交易指令</td></tr><tr><td>showOrder</td><td>String</td><td>是</td><td>显示顺序</td><td>从小到大显示</td></tr></tbody></table>

# 交易时间戳

- JSON Key为`transTimestamp`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-t"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>traceNo</td><td>String</td><td>是</td><td>原交易收银机流水号</td><td>必须包含yyyyMMdd(当天)</td></tr><tr><td>send</td><td>String</td><td>是</td><td>发送时间</td><td>Unix时间戳,单位：秒</td></tr><tr><td>recv</td><td>String</td><td>是</td><td>接收时间</td><td>Unix时间戳,单位：秒</td></tr></tbody></table>

# 交易记录明细

- JSON Key为`transInfo`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-a"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>action</td><td>String</td><td>是</td><td>交易action</td><td>  
</td></tr><tr><td>traceNo</td><td>String</td><td>是</td><td>交易收银机流水号</td><td>必须包含yyyyMMdd(当天)</td></tr><tr><td>orderNo</td><td>String</td><td>是</td><td>易百系统参考号</td><td>  
</td></tr><tr><td>transDate</td><td>String</td><td>是</td><td>交易时间</td><td>格式：yyyyMMddHHmmss</td></tr><tr><td>returnCode</td><td>String</td><td>是</td><td>返回码</td><td>00表示交易成功，其他表示失败</td></tr><tr><td>returnDesc</td><td>String</td><td>是</td><td>返回信息</td><td>交易结果描述或错误原因</td></tr><tr><td>paidAmount</td><td>String</td><td>是</td><td>交易成功金额</td><td>  
</td></tr><tr><td>activityProductNo</td><td>String</td><td>是</td><td>活动产品编号</td><td>  
</td></tr><tr><td>activityProductName</td><td>String</td><td>是</td><td>活动产品名称</td><td>活动名称+产品名称</td></tr><tr><td>bank</td><td>String</td><td>是</td><td>交易机构标识</td><td>  
</td></tr><tr><td>cardNo64</td><td>String</td><td>是</td><td>卡号或串码</td><td>  
</td></tr><tr><td>printContent</td><td>String</td><td>是</td><td>小票打印数据</td></tr></tbody></table>

# 功能菜单

- JSON Key为`function`，出现在返回报文中

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-i"><thead><tr><th class="align-center" style="width: 99px;">字段</th><th class="align-center" style="width: 124px;">类型</th><th class="align-center" style="width: 84px;">是否必填</th><th class="align-center" style="width: 201px;">字段意义</th><th class="align-center" style="width: 301px;">备注</th></tr></thead><tbody><tr><td class="align-center" style="width: 99px;">iconUrl</td><td class="align-center" style="width: 124px;">String</td><td class="align-center" style="width: 84px;">是</td><td class="align-center" style="width: 201px;">用于功能显示icon图下载URL</td><td class="align-center" style="width: 301px;">变长</td></tr><tr><td class="align-center" style="width: 99px;">title</td><td class="align-center" style="width: 124px;">String</td><td class="align-center" style="width: 84px;">是</td><td class="align-center" style="width: 201px;">用于功能名称显示</td><td class="align-center" style="width: 301px;">变长</td></tr><tr><td class="align-center" style="width: 99px;">action</td><td class="align-center" style="width: 124px;">String</td><td class="align-center" style="width: 84px;">是</td><td class="align-center" style="width: 201px;">功能对应的后台处理路径</td><td class="align-center" style="width: 301px;">变长</td></tr><tr><td class="align-center" style="width: 99px;">command</td><td class="align-center" style="width: 124px;">String</td><td class="align-center" style="width: 84px;">是</td><td class="align-center" style="width: 201px;">用于下发功能所有执行的指令</td><td class="align-center" style="width: 301px;">例如:04|00|请刷磁条卡|1|08|00|暴风雪(中)$HDCP00000000072578|0|</td></tr><tr><td class="align-center" style="width: 99px;">childrenFunc</td><td class="align-center" style="width: 124px;">List&lt;[function](https://book.e-buy.com/books/e-buy-B6z/page/c058f)&gt;</td><td class="align-center" style="width: 84px;">否</td><td class="align-center" style="width: 201px;">功能下的子项</td><td class="align-center" style="width: 301px;">变长</td></tr></tbody></table>

# 图片信息

- JSON Key为`headPicture`，出现在返回报文中

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-d"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>displayPicUrl</td><td>String</td><td>是</td><td>用于广告显示图片下载URL</td><td>变长</td></tr><tr><td>linkUrl</td><td>String</td><td>是</td><td>用于点击广告图片后要跳转的页面URL</td><td>变长</td></tr></tbody></table>

# 包裹明细

- JSON Key为`packageDetail`，出现在返回报文中

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-p"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>packId</td><td>String</td><td>是</td><td>打包ID</td><td>变长</td></tr><tr><td>packName</td><td>String</td><td>是</td><td>打包名称</td><td> </td></tr><tr><td>goodsInfoList</td><td>List&lt;[goodsDetail](https://book.e-buy.com/link/159#bkmrk-page-title "goodsDetail")&gt;</td><td>是</td><td>产品明细</td></tr></tbody></table>

# 订单信息

- JSON Key为`orderInfo`，出现在返回报文中，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-a"><thead><tr><th style="width: 127px;">字段</th><th style="width: 146px;">类型</th><th style="width: 50px;">是否必填</th><th style="width: 107px;">字段意义</th><th style="width: 379px;">备注</th></tr></thead><tbody><tr><td style="width: 127px;">appOrderNo</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">应用订单号</td><td style="width: 379px;">变长</td></tr><tr><td style="width: 127px;">statusCode</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">订单状态码</td><td style="width: 379px;">变长</td></tr><tr><td style="width: 127px;">status</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">订单状态</td><td style="width: 379px;">订单状态汉字描述</td></tr><tr><td style="width: 127px;">orderTime</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">订单时间</td><td style="width: 379px;">格式HH:mm,用于订单列表页面显示</td></tr><tr><td style="width: 127px;">orderCreateTime</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">订单时间</td><td style="width: 379px;">格式yyyy-MM-dd HH:mm:ss</td></tr><tr><td style="width: 127px;">orderAmount</td><td style="width: 146px;">Price</td><td style="width: 50px;">是</td><td style="width: 107px;">订单金额</td><td style="width: 379px;"> </td></tr><tr><td style="width: 127px;">rcptName</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">收货人</td><td style="width: 379px;"> </td></tr><tr><td style="width: 127px;">platformName</td><td style="width: 146px;">String</td><td style="width: 50px;">是</td><td style="width: 107px;">平台名称</td><td style="width: 379px;">变长,说明订单是来自百度，美团平台,长度不超过四个汉字</td></tr><tr><td style="width: 127px;">packageDetailList</td><td style="width: 146px;">List&lt;[packageDetail](https://book.e-buy.com/link/171#bkmrk-page-title "packageDetail")&gt;</td><td style="width: 50px;">否</td><td style="width: 107px;">订单包裹明细</td><td style="width: 379px;">该节点在调用订单明细接口时才会有数据下发</td></tr></tbody></table>

# 优惠券明细

- JSON Key为`voucherDetail`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-v" style="width: 68.7654%; height: 353.382px;"><thead><tr style="height: 29.4485px;"><th style="width: 23.3079%; height: 29.4485px;">字段</th><th style="width: 9.54101%; height: 29.4485px;">类型</th><th style="width: 13.1036%; height: 29.4485px;">是否必填</th><th style="width: 25.6709%; height: 29.4485px;">字段意义</th><th style="width: 28.184%; height: 29.4485px;">备注</th></tr></thead><tbody><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">voucherId</td><td style="width: 9.54101%; height: 29.4485px;">String</td><td style="width: 13.1036%; height: 29.4485px;">是</td><td style="width: 25.6709%; height: 29.4485px;">优惠券编号</td><td style="width: 28.184%; height: 29.4485px;">  
</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">voucherName</td><td style="width: 9.54101%; height: 29.4485px;">String</td><td style="width: 13.1036%; height: 29.4485px;">是</td><td style="width: 25.6709%; height: 29.4485px;">优惠券名称</td><td style="width: 28.184%; height: 29.4485px;">用于报表、小票等显示</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">voucherType</td><td style="width: 9.54101%; height: 29.4485px;">String</td><td style="width: 13.1036%; height: 29.4485px;">是</td><td style="width: 25.6709%; height: 29.4485px;">优惠券类型</td><td style="width: 28.184%; height: 29.4485px;">  
</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">voucherAmount</td><td style="width: 9.54101%; height: 29.4485px;">Price</td><td style="width: 13.1036%; height: 29.4485px;">是</td><td style="width: 25.6709%; height: 29.4485px;">单价</td><td style="width: 28.184%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">merchantDiscount</td><td style="width: 9.54101%; height: 29.4485px;">Price</td><td style="width: 13.1036%; height: 29.4485px;">否</td><td style="width: 25.6709%; height: 29.4485px;">商户优惠金额</td><td style="width: 28.184%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">userDiscount</td><td style="width: 9.54101%; height: 29.4485px;">Price</td><td style="width: 13.1036%; height: 29.4485px;">否</td><td style="width: 25.6709%; height: 29.4485px;">用户购券金额</td><td style="width: 28.184%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">platformDiscount</td><td style="width: 9.54101%; height: 29.4485px;">Price</td><td style="width: 13.1036%; height: 29.4485px;">否</td><td style="width: 25.6709%; height: 29.4485px;">平台优惠补贴金额</td><td style="width: 28.184%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">otherDiscount</td><td style="width: 9.54101%; height: 29.4485px;">Price</td><td style="width: 13.1036%; height: 29.4485px;">否</td><td style="width: 25.6709%; height: 29.4485px;">其他出资方补贴金额</td><td style="width: 28.184%; height: 29.4485px;">单位：元</td></tr><tr style="height: 29.4485px;"><td style="width: 23.3079%; height: 29.4485px;">voucherCode</td><td style="width: 9.54101%; height: 29.4485px;">String</td><td style="width: 13.1036%; height: 29.4485px;">是</td><td style="width: 25.6709%; height: 29.4485px;">优惠券串号</td><td style="width: 28.184%; height: 29.4485px;">  
</td></tr></tbody></table>

# 批量核销明细

- JSON Key为`ecouponsData`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c"><thead><tr><th style="width: 147px;">字段</th><th style="width: 166px;">类型</th><th style="width: 46px;">是否必填</th><th style="width: 172px;">字段意义</th><th style="width: 276px;">备注</th></tr></thead><tbody><tr><td style="width: 147px;">code</td><td style="width: 166px;">String</td><td style="width: 46px;">是</td><td style="width: 172px;">劵码</td><td style="width: 276px;">  
</td></tr><tr><td class="align-left" style="width: 147px;">status</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">是</td><td class="align-left" style="width: 172px;">核销结果返回码</td><td class="align-left" style="width: 276px;">00表示核销成功,其他失败</td></tr><tr><td class="align-left" style="width: 147px;">desc</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">是</td><td class="align-left" style="width: 172px;">核销结果描述</td><td class="align-left" style="width: 276px;">  
</td></tr><tr><td class="align-left" style="width: 147px;">paidAmount</td><td class="align-left" style="width: 166px;">Price</td><td class="align-left" style="width: 46px;">是</td><td class="align-left" style="width: 172px;">支付成功总金额</td><td class="align-left" style="width: 276px;">单位：元</td></tr><tr><td class="align-left" style="width: 147px;">receiptAmount</td><td class="align-left" style="width: 166px;">Price</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">商户实收金额</td><td class="align-left" style="width: 276px;">单位：元</td></tr><tr><td class="align-left" style="width: 147px;">invoiceAmount</td><td class="align-left" style="width: 166px;">Price</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">商户开票金额</td><td class="align-left" style="width: 276px;">单位：元</td></tr><tr><td class="align-left" style="width: 147px;">lockTime</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">是</td><td class="align-left" style="width: 172px;">锁定时间,单位（秒）</td><td class="align-left" style="width: 276px;">默认：300</td></tr><tr><td class="align-left" style="width: 147px;">afterLock</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">是</td><td class="align-left" style="width: 172px;">锁定到期后处理，核销：1，解锁：0</td><td class="align-left" style="width: 276px;">默认：0</td></tr><tr><td class="align-left" style="width: 147px;">exchangeRate</td><td class="align-left" style="width: 166px;">Number(8,6)</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">汇率</td><td class="align-left" style="width: 276px;">1外币等于多少人民币</td></tr><tr><td class="align-left" style="width: 147px;">currency</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">货币类型</td><td class="align-left" style="width: 276px;">例如:CNY</td></tr><tr><td class="align-left" style="width: 147px;">discountCode</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">折扣编码</td><td class="align-left" style="width: 276px;">由收银机分配，用于入账计折扣类型</td></tr><tr><td class="align-left" style="width: 147px;">discountNum</td><td class="align-left" style="width: 166px;">Number</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">固定金额折扣数量</td><td class="align-left" style="width: 276px;">用于入账计折扣类型的数量</td></tr><tr><td class="align-left" style="width: 147px;">tenderCode</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">支付方式编码</td><td class="align-left" style="width: 276px;">由收银机分配，用于入账计支付方式</td></tr><tr><td class="align-left" style="width: 147px;">activityProductNo</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">活动产品编号</td><td class="align-left" style="width: 276px;">  
</td></tr><tr><td class="align-left" style="width: 147px;">activityProductName</td><td class="align-left" style="width: 166px;">String</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">活动产品名称</td><td class="align-left" style="width: 276px;">  
</td></tr><tr><td class="align-left" style="width: 147px;">goodsDetail</td><td class="align-left" style="width: 166px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">折抵产品明细</td><td class="align-left" style="width: 276px;">返回后台已抵扣成功的产品明细</td></tr><tr><td class="align-left" style="width: 147px;">fundChannel</td><td class="align-left" style="width: 166px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">资金渠道</td><td class="align-left" style="width: 276px;">  
</td></tr><tr><td class="align-left" style="width: 147px;">printDetail</td><td class="align-left" style="width: 166px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">打印信息</td><td class="align-left" style="width: 276px;">如需要在收银小票上打印信息时必填</td></tr><tr><td class="align-left" style="width: 147px;">memberDetail</td><td class="align-left" style="width: 166px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">会员信息</td><td class="align-left" style="width: 276px;">返回本次交易的会员信息</td></tr><tr><td class="align-left" style="width: 147px;">voucherDetail</td><td class="align-left" style="width: 166px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td class="align-left" style="width: 46px;">否</td><td class="align-left" style="width: 172px;">优惠券信息</td><td class="align-left" style="width: 276px;">返回本次交易的优惠券信息</td></tr></tbody></table>

# 批量核销劵码

- JSON Key为`codeInfo`，必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>code</td><td>String</td><td>是</td><td>劵码</td><td> </td></tr><tr><td>activityProductNo</td><td>String</td><td>否</td><td>活动产品编号</td><td>  
</td></tr><tr><td>ext</td><td>String</td><td>否</td><td>扩展字段</td><td>  
</td></tr></tbody></table>

# 扩展信息

- JSON Key为`extendsData`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-v" style="width: 100%; height: 1323.46px;"><thead><tr style="height: 46.5918px;"><th style="width: 16.3164%; height: 46.5918px;">字段</th><th style="width: 8.65262%; height: 46.5918px;">类型</th><th style="width: 12.3518%; height: 46.5918px;">是否必填</th><th style="width: 18.9213%; height: 46.5918px;">字段意义</th><th style="width: 43.6339%; height: 46.5918px;">备注</th></tr></thead><tbody><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">vUseInfo</td><td style="width: 8.65262%; height: 46.5918px;">String</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">劵使用须知</td><td style="width: 43.6339%; height: 46.5918px;">  
</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">vDiscountDesc</td><td style="width: 8.65262%; height: 46.5918px;">String</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">劵优惠说明</td><td style="width: 43.6339%; height: 46.5918px;">  
</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">vUseRule</td><td style="width: 8.65262%; height: 46.5918px;">String</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">劵使用规则</td><td style="width: 43.6339%; height: 46.5918px;">  
</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">activityProductId</td><td style="width: 8.65262%; height: 46.5918px;">String</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">活动产品id</td><td style="width: 43.6339%; height: 46.5918px;">  
</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">userRealAmount</td><td style="width: 8.65262%; height: 46.5918px;">Price</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">用户实付金额</td><td style="width: 43.6339%; height: 46.5918px;">单位元</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">defaultGoodsId</td><td style="width: 8.65262%; height: 46.5918px;">String</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">默认上屏ID产品 id</td><td style="width: 43.6339%; height: 46.5918px;">如果值为空或者goodsDetail的size是1都不支持更换</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">oriCode</td><td style="width: 8.65262%; height: 46.5918px;">String</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">请求对应的原券码</td><td style="width: 43.6339%; height: 46.5918px;">  
</td></tr><tr style="height: 113.77px;"><td style="width: 16.3164%; height: 113.77px;">ticketType</td><td style="width: 8.65262%; height: 113.77px;">String</td><td style="width: 12.3518%; height: 113.77px;">否</td><td style="width: 18.9213%; height: 113.77px;">券所属类型</td><td style="width: 43.6339%; height: 113.77px;">-------电子券ticketType----------  
ebuy代金券: cashCoupon  
ebuy产品券：merchandiseCoupon  
ebuy折扣券：discountCoupon  
ebuy满减券：fullReduceCoupon  
ebuy买赠券：buyGetCoupon</td></tr><tr style="height: 43.938px;"><td style="width: 16.3164%; height: 43.938px;">cardSearchCode</td><td style="width: 8.65262%; height: 43.938px;">String</td><td style="width: 12.3518%; height: 43.938px;">否</td><td style="width: 18.9213%; height: 43.938px;">现金卡对应的查询码</td><td style="width: 43.6339%; height: 43.938px;"></td></tr><tr style="height: 214.609px;"><td style="width: 16.3164%; height: 214.609px;">voucherDetail</td><td style="width: 8.65262%; height: 214.609px;">String</td><td style="width: 12.3518%; height: 214.609px;">是</td><td style="width: 18.9213%; height: 214.609px;">易百券相关信息</td><td style="width: 43.6339%; height: 214.609px;">createTime String 创建时间

validStart String 券有效期开始时间  
validEnd String 券有效期结束时间  
ticketId String 券id 511293,

ticketName String 券名  
status String 状态 00

00 可使用   
01 已使用   
02 可使用(一码多次使用时，码还有可用次数)   
03 未激活 未激活的码需调用激活接口才能  
04 已冻结   
05 已作废   
06 已过期   
07 未生效 当制码时选择次日生效，核销时会返回该状态  
08 不能退款 仅核销场景-不支持核销撤销(根据业务场景配置是否支持隔日和当日核销撤销)  
09 券不存在 券码不存在(券码查询、核销、核销撤销)  
21 电子凭证不可用   
券码不在有效期

35 码配置异常   
51 改码不存在制码方   
97 报文错误 接口调用参数校验不通过

statusDesc String 状态描述

faceValue BigDecimal 面值（分）  
activateTime String 激活时间 (可以为空)

</td></tr><tr style="height: 46.5918px;"><td style="width: 16.3164%; height: 46.5918px;">isRefund</td><td style="width: 8.65262%; height: 46.5918px;">int</td><td style="width: 12.3518%; height: 46.5918px;">否</td><td style="width: 18.9213%; height: 46.5918px;">查询原消费交易时如发生过退款此时isRefund=1</td><td style="width: 43.6339%; height: 46.5918px;">注意isRefund=1时仅表示消费交易有过退款操作，并不表示消费金额已全部退完</td></tr><tr><td style="width: 16.3164%;">[verifyOptions](https://book.e-buy.com/books/e-buy-B6z/page/0353a)</td><td style="width: 8.65262%;">Objetc</td><td style="width: 12.3518%;">否</td><td style="width: 18.9213%;">抖音核销专用返回</td><td style="width: 43.6339%;">  
</td></tr><tr><td style="width: 16.3164%;"><span data-slate-fragment="JTVCJTdCJTIydHlwZSUyMiUzQSUyMnBhcmFncmFwaCUyMiUyQyUyMmNoaWxkcmVuJTIyJTNBJTVCJTdCJTIyaWQlMjIlM0ElMjJWa2xMYTZ4UFd6JTIyJTJDJTIycGFyYUlkeCUyMiUzQTAlMkMlMjJzcmMlMjIlM0ElMjJpbnZvaWNlSW5mbyUyMiUyQyUyMmRzdCUyMiUzQSUyMiVFNSU4RiU5MSVFNyVBNSVBOCVFNCVCRiVBMSVFNiU4MSVBRiUyMiUyQyUyMm1ldGFkYXRhJTIyJTNBJTIyJTIyJTJDJTIybWF0Y2hlcyUyMiUzQW51bGwlMkMlMjJtZXRhRGF0YSUyMiUzQSU1QiU1RCUyQyUyMnRleHQlMjIlM0ElMjJpbnZvaWNlSW5mbyUyMiU3RCU1RCU3RCU1RA==">invoiceInfo</span></td><td style="width: 8.65262%;">String</td><td style="width: 12.3518%;">否</td><td style="width: 18.9213%;">Costa支付宝企业付开票信息约定返回</td><td style="width: 43.6339%;"><span data-slate-fragment="JTVCJTdCJTIydHlwZSUyMiUzQSUyMnBhcmFncmFwaCUyMiUyQyUyMmNoaWxkcmVuJTIyJTNBJTVCJTdCJTIyaWQlMjIlM0ElMjJWa2xMYTZ4UFd6JTIyJTJDJTIycGFyYUlkeCUyMiUzQTAlMkMlMjJzcmMlMjIlM0ElMjJpbnZvaWNlSW5mbyUyMiUyQyUyMmRzdCUyMiUzQSUyMiVFNSU4RiU5MSVFNyVBNSVBOCVFNCVCRiVBMSVFNiU4MSVBRiUyMiUyQyUyMm1ldGFkYXRhJTIyJTNBJTIyJTIyJTJDJTIybWF0Y2hlcyUyMiUzQW51bGwlMkMlMjJtZXRhRGF0YSUyMiUzQSU1QiU1RCUyQyUyMnRleHQlMjIlM0ElMjJpbnZvaWNlSW5mbyUyMiU3RCU1RCU3RCU1RA==">\[{  
 "activityNo": "2014030701",  
 "amount": 12.7,  
 "isInvoice": true  
 },  
 {  
 "activityNo": "2025020801",  
 "amount": 41.3  
 }  
\]</span>

<span data-slate-fragment="JTVCJTdCJTIydHlwZSUyMiUzQSUyMnBhcmFncmFwaCUyMiUyQyUyMmNoaWxkcmVuJTIyJTNBJTVCJTdCJTIyaWQlMjIlM0ElMjJWa2xMYTZ4UFd6JTIyJTJDJTIycGFyYUlkeCUyMiUzQTAlMkMlMjJzcmMlMjIlM0ElMjJpbnZvaWNlSW5mbyUyMiUyQyUyMmRzdCUyMiUzQSUyMiVFNSU4RiU5MSVFNyVBNSVBOCVFNCVCRiVBMSVFNiU4MSVBRiUyMiUyQyUyMm1ldGFkYXRhJTIyJTNBJTIyJTIyJTJDJTIybWF0Y2hlcyUyMiUzQW51bGwlMkMlMjJtZXRhRGF0YSUyMiUzQSU1QiU1RCUyQyUyMnRleHQlMjIlM0ElMjJpbnZvaWNlSW5mbyUyMiU3RCU1RCU3RCU1RA==">返回如上JSON数组格式，isInvoice=true时表示此金额为开票字段</span>

</td></tr></tbody></table>

# 集点明细

- JSON Key为`pointDetail`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-a"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>activityNo</td><td>String</td><td>是</td><td>集点活动编号</td><td> </td></tr><tr><td>points</td><td>Integer</td><td>是</td><td>集点点数</td></tr></tbody></table>

# 签购单信息

- JSON Key为purchaseOrder，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-m" style="width: 675px;"><thead><tr><th style="width: 114px;">字段</th><th style="width: 58px;">类型</th><th style="width: 48px;">是否必填</th><th style="width: 145px;">字段意义</th><th style="width: 310px;">备注</th></tr></thead><tbody><tr><td style="width: 114px;">mid</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">商户编号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">tid</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">终端编号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">merchantName</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">商户名称</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">acquiere</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">收单行标识码</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">issuer</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">发卡行标识码</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">cardNo</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">卡号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">batchNo</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">批次号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">voucherNo</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">凭证号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">authNo</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">授权码</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">referNo</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">系统参考号</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">date</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">日期</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">expDate</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">卡有效期</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">transType</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">交易类型</td><td style="width: 310px;">中间件还需根据用卡方式拼接上（括号和括号内的字母）：刷卡:（S）、插卡：（I）、挥卡：（C）、手卡号输：（M）</td></tr><tr><td style="width: 114px;">amount</td><td style="width: 58px;">String</td><td style="width: 48px;"> </td><td style="width: 145px;">交易金额</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">wildcard</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">国际信用卡公司代码</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">TC</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">TC</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">ARQC</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">ARQC</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">TVR</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">TVR</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">TSI</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">TSI</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">AID</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">AID</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">ATC</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">ATC</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">APPLAB</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">APPLAB</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">APPName</td><td style="width: 58px;">String</td><td style="width: 48px;">否</td><td style="width: 145px;">APPName</td><td style="width: 310px;"> </td></tr><tr><td style="width: 114px;">reMark</td><td style="width: 58px;">String</td><td style="width: 48px;">是</td><td style="width: 145px;">备注信息</td><td style="width: 310px;">备注信息 LLVAR190 [MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能") Client负责备注栏信息分行打印，不去管具体信息内容。 要求： 1.每行信息用';'分割。 2．如有中文提示，比如原凭证号，原授权号，则请加上这些信息。 3．重打印标志由[MIS-POS](https://book.e-buy.com/link/104#bkmrk-mis-pos "安装于商户门店内的POS机具，提供活动执行辅助及兑换功能") Client判断，故EMV-POS不需要 重打印凭证/DUPLICATED 这条备注信息。</td></tr></tbody></table>

# 机构信息

- JSON Key为`orgLogInInfo`，出现在请求报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-l"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>loginIndex</td><td>String</td><td>是</td><td>对应签到标志的寻位索引</td><td> </td></tr><tr><td>mid</td><td>String</td><td>否</td><td>机构商户号</td><td> </td></tr><tr><td>tid</td><td>String</td><td>否</td><td>机构终端号</td><td> </td></tr><tr><td>merchantName</td><td>String</td><td>否</td><td>机构商户名称</td><td> </td></tr><tr><td>serviceIp</td><td>String</td><td>否</td><td>机构服务IP</td><td> </td></tr><tr><td>servicePort</td><td>String</td><td>否</td><td>机构服务端口</td><td> </td></tr><tr><td>serviceUrl</td><td>String</td><td>否</td><td>机构服务url</td></tr></tbody></table>

# 电子券包本信息

箱信息：

JSON Key为`voucherBox`，出现在请求报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-b"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>boxId</td><td>String</td><td>是</td><td>电子券箱号</td><td> </td></tr><tr><td>voucherPkg</td><td>List&lt;voucherPkg&gt;</td><td>否</td><td>电子券包信息</td></tr></tbody></table>

包信息：

JSON Key为`voucherPkg`，出现在请求报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-p"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>pkgId</td><td>String</td><td>是</td><td>电子券包号</td><td> </td></tr><tr><td>voucherReel</td><td>List&lt;voucherReel&gt;</td><td>否</td><td>电子券本信息</td></tr></tbody></table>

本信息：

JSON Key为`voucherReel`，出现在请求报文中，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-r"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>reelId</td><td>String</td><td>是</td><td>电子券本号</td><td> </td></tr><tr><td>codeDetail</td><td>List&lt;codeDetail&gt;</td><td>否</td><td>电子券券号</td></tr></tbody></table>

券信息：

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-c" style="width: 67.1429%; height: 900px;"><thead><tr style="height: 29.6px;"><th style="width: 24.6804%; height: 29.6px;">字段</th><th style="width: 12.0739%; height: 29.6px;">类型</th><th style="width: 12.9616%; height: 29.6px;">是否必填</th><th style="width: 25.3906%; height: 29.6px;">字段意义</th><th style="width: 25.0355%; height: 29.6px;">备注</th></tr></thead><tbody><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">code</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">电子凭证码</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">saleChannelOrderId</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">取码方制码订单号</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">saleChannelName</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">取码方名称</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">sendChannelName</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">制码方名称</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">remainTimes</td><td style="width: 12.0739%; height: 29.6px;">Integer</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">剩余核销次数</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">createDate</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">码创建日期</td><td style="width: 25.0355%; height: 29.6px;">yyyyMMdd</td></tr><tr style="height: 46.4px;"><td style="width: 24.6804%; height: 46.4px;">createTime</td><td style="width: 12.0739%; height: 46.4px;">String</td><td style="width: 12.9616%; height: 46.4px;">是</td><td style="width: 25.3906%; height: 46.4px;">码创建时间</td><td style="width: 25.0355%; height: 46.4px;">yyyyMMddHHmmss</td></tr><tr style="height: 46.4px;"><td style="width: 24.6804%; height: 46.4px;">validStart</td><td style="width: 12.0739%; height: 46.4px;">String</td><td style="width: 12.9616%; height: 46.4px;">否</td><td style="width: 25.3906%; height: 46.4px;">码有效开始时间</td><td style="width: 25.0355%; height: 46.4px;">yyyyMMddHHmmss</td></tr><tr style="height: 46.4px;"><td style="width: 24.6804%; height: 46.4px;">validEnd</td><td style="width: 12.0739%; height: 46.4px;">String</td><td style="width: 12.9616%; height: 46.4px;">否</td><td style="width: 25.3906%; height: 46.4px;">码有效结束时间</td><td style="width: 25.0355%; height: 46.4px;">yyyyMMddHHmmss</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">activateDate</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">否</td><td style="width: 25.3906%; height: 29.6px;">激活日期</td><td style="width: 25.0355%; height: 29.6px;">yyyyMMdd</td></tr><tr style="height: 46.4px;"><td style="width: 24.6804%; height: 46.4px;">activateTime</td><td style="width: 12.0739%; height: 46.4px;">String</td><td style="width: 12.9616%; height: 46.4px;">否</td><td style="width: 25.3906%; height: 46.4px;">激活时间</td><td style="width: 25.0355%; height: 46.4px;">yyyyMMddHHmmss</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">activateShopNo</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">否</td><td style="width: 25.3906%; height: 29.6px;">激活门店</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">verifyDate</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">否</td><td style="width: 25.3906%; height: 29.6px;">码核销日期</td><td style="width: 25.0355%; height: 29.6px;">yyyyMMdd</td></tr><tr style="height: 46.4px;"><td style="width: 24.6804%; height: 46.4px;">verifyTime</td><td style="width: 12.0739%; height: 46.4px;">String</td><td style="width: 12.9616%; height: 46.4px;">否</td><td style="width: 25.3906%; height: 46.4px;">码核销时间</td><td style="width: 25.0355%; height: 46.4px;">yyyyMMddHHmmss</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">status</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">状态</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">statusDesc</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">状态描述</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 46.4px;"><td style="width: 24.6804%; height: 46.4px;">cityCheck</td><td style="width: 12.0739%; height: 46.4px;">String</td><td style="width: 12.9616%; height: 46.4px;">是</td><td style="width: 25.3906%; height: 46.4px;">劵所在城市是否可用</td><td style="width: 25.0355%; height: 46.4px;">Y可用N不可用</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">ticketId</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">券id</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">ticketName</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">券名称</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">activityId</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">活动id</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">activityName</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">活动名称</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">faceValue</td><td style="width: 12.0739%; height: 29.6px;">Number</td><td style="width: 12.9616%; height: 29.6px;">否</td><td style="width: 25.3906%; height: 29.6px;">券面值</td><td style="width: 25.0355%; height: 29.6px;">单位：分</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">shopNo</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">否</td><td style="width: 25.3906%; height: 29.6px;">核销门店编号</td><td style="width: 25.0355%; height: 29.6px;"> </td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">shopName</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">否</td><td style="width: 25.3906%; height: 29.6px;">核销门店名称</td><td style="width: 25.0355%; height: 29.6px;">  
</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">cityName</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">城市名称</td><td style="width: 25.0355%; height: 29.6px;">武汉市</td></tr><tr style="height: 29.6px;"><td style="width: 24.6804%; height: 29.6px;">cityCode</td><td style="width: 12.0739%; height: 29.6px;">String</td><td style="width: 12.9616%; height: 29.6px;">是</td><td style="width: 25.3906%; height: 29.6px;">城市编码</td><td style="width: 25.0355%; height: 29.6px;">武汉市</td></tr></tbody></table>

# 账户信息

- JSON Key为`accountInfo`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-m"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>memberCode</td><td>String</td><td>是</td><td>账号编号</td><td>accountType是5时，此字段是券码</td></tr><tr><td>accountType</td><td>String</td><td>是</td><td>账户类型。1:易百会员ID,2:手机号码,3:支付宝ID, 4:微信OPENID，5：券码（添加）</td></tr></tbody></table>

# 会员积分

- JSON Key为`point`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-p"><thead><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr></thead><tbody><tr><td>points</td><td>String</td><td>是</td><td>积分总数</td><td>  
</td></tr><tr><td>deductileAmount</td><td>String</td><td>是</td><td>可抵扣金额</td><td>  
</td></tr><tr><td>validDate</td><td>String</td><td>否</td><td>即将过期日期</td><td>格式：YYYYMMDDhhmmss</td></tr><tr><td>invalidPoints</td><td>String</td><td>否</td><td>即将过期积分数 </td></tr></tbody></table>

# 会员电子券

- JSON Key为`vouchers`，非必填

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-v" style="height: 695px;"><thead><tr style="height: 77px;"><th style="width: 149px; height: 35px;">字段</th><th style="width: 132px; height: 35px;">类型</th><th style="width: 47px; height: 35px;">是否必填</th><th style="width: 300px; height: 35px;">字段意义</th><th style="width: 181px; height: 35px;">备注</th></tr></thead><tbody><tr style="height: 29px;"><td style="width: 149px; height: 29px;">voucherType</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">是</td><td style="width: 300px; height: 29px;">coupon电子券，rights权益，cashCard现金卡</td><td style="width: 181px; height: 29px;">枚举类型，易百提供</td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">code</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">是</td><td style="width: 300px; height: 29px;">码号或卡号</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">faceAmount</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">是</td><td style="width: 300px; height: 29px;">面值</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 45px;"><td style="width: 149px; height: 45px;">validDate</td><td style="width: 132px; height: 45px;">String</td><td style="width: 47px; height: 45px;">是</td><td style="width: 300px; height: 45px;">使用有效期</td><td style="width: 181px; height: 45px;">格式：YYYYMMDD-YYYYMMDD</td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">voucherStatus</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">是</td><td style="width: 300px; height: 29px;">状态</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">voucherStatusDesc</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">是</td><td style="width: 300px; height: 29px;">状态描述</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">tenderDiscountCode</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">使用电子券和权益时返回</td><td style="width: 181px; height: 29px;">格式：支付编码｜折扣编码</td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">cardAmount</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">现金卡剩余金额，使用现金卡时返回</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">merchatRealAmount</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">商户实收金额，使用电子券和权益时返回</td><td style="width: 181px; height: 29px;">特殊字段需与ebuy确认</td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">discountAmount</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">商户优惠金额，使用电子券和权益时返回</td><td style="width: 181px; height: 29px;">特殊字段需与ebuy确认</td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">userInvoiceAmount</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">给用户开票的金额</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">ebuyInvoiceAmount</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">给易百开票的金额，使用电子券和权益时返回</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 45px;"><td style="width: 149px; height: 45px;">platformCode</td><td style="width: 132px; height: 45px;">String</td><td style="width: 47px; height: 45px;">否</td><td style="width: 300px; height: 45px;">平台编码，易百提供（天猫（Tmall），淘宝（TaoBao），拼多多（PDD），京东（JD））</td><td style="width: 181px; height: 45px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">activityProductNo</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">活动产品编号</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">remainTimes</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">当前可使用次数，使用电子券和权益时返回</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">totalTimes</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">总使用次数，使用电子券和权益时返回</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 40px;"><td style="width: 149px; height: 40px;">voucherScope</td><td style="width: 132px; height: 40px;">String</td><td style="width: 47px; height: 40px;">否</td><td style="width: 300px; height: 40px;">商户定制规则使用字段，配置部分原样下发</td><td style="width: 181px; height: 40px;">例如：商户券分类，就餐时间规则，使用条件限制</td></tr><tr style="height: 29px;"><td style="width: 149px; height: 29px;">defaultGoodsId</td><td style="width: 132px; height: 29px;">String</td><td style="width: 47px; height: 29px;">否</td><td style="width: 300px; height: 29px;">默认上屏产品 id，多产品时返回</td><td style="width: 181px; height: 29px;"> </td></tr><tr style="height: 95px;"><td style="width: 149px; height: 95px;">goodsDetail</td><td style="width: 132px; height: 95px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 47px; height: 95px;">否</td><td style="width: 300px; height: 95px;">折抵产品明细</td></tr></tbody></table>

# 卡券明细

- JSON Key为codeDetail，非必填 <table border="1" style="border-collapse: collapse; width: 117.962%; height: 264px;"><colgroup><col style="width: 16.6443%;"></col><col style="width: 10.7363%;"></col><col style="width: 9.93487%;"></col><col style="width: 17.1812%;"></col><col style="width: 45.5034%;"></col></colgroup><tbody><tr><th>字段</th><th>类型</th><th>是否必填</th><th>字段意义</th><th>备注</th></tr><tr><td>code</td><td>String</td><td>是</td><td>卡券号</td><td>请求时上送，原样返回</td></tr><tr><td>password</td><td>String</td><td>否</td><td>卡密码</td><td>请求时上送</td></tr><tr><td>ticketId</td><td>String</td><td>是</td><td>券批次id</td><td>后端返回</td></tr><tr><td>ticketName</td><td>String</td><td>是</td><td>券批次名称</td><td>后端返回</td></tr><tr><td>useTimes</td><td>Number</td><td>是</td><td>可用次数</td><td>后端返回</td></tr><tr><td>resultCode</td><td>String</td><td>是</td><td>操作结果码</td><td>后端返回</td></tr><tr><td>resultDesc</td><td>String</td><td>是</td><td>操作结果描述</td><td>后端返回</td></tr><tr><td>cardNetValue</td><td>Price</td><td>否</td><td>净值（单位：元）</td><td>请求时上送</td></tr></tbody></table>

# 扩展信息-抖音线上核销报文

- JSON Key为<span style="background-color: rgb(236, 240, 241);">verifyOptions</span>，非必填，包含如下三个字段（verifyToken，poiId， orderList）

<table id="bkmrk-%E5%AD%97%E6%AE%B5-%E7%B1%BB%E5%9E%8B-%E6%98%AF%E5%90%A6%E5%BF%85%E5%A1%AB-%E5%AD%97%E6%AE%B5%E6%84%8F%E4%B9%89-%E5%A4%87%E6%B3%A8-v" style="width: 111.605%; height: 615.448px;"><thead><tr style="height: 46.5625px;"><th style="width: 16.4333%; height: 46.5625px;">字段</th><th style="width: 17.2982%; height: 46.5625px;">类型</th><th style="width: 9.01977%; height: 46.5625px;">是否必填</th><th style="width: 33.7333%; height: 46.5625px;">字段意义</th><th style="width: 23.4743%; height: 46.5625px;">备注</th></tr></thead><tbody><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;"><div>verifyToken</div></td><td style="width: 17.2982%; height: 46.5625px;">String</td><td style="width: 9.01977%; height: 46.5625px;">是</td><td style="width: 33.7333%; height: 46.5625px;"><div>相同 token的结果幂等，开发者⾃⾏⽣成，⻓度需⼤于 4 字节⼩于 64 字节</div></td><td style="width: 23.4743%; height: 46.5625px;">  
</td></tr><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;"><div>poiId</div></td><td style="width: 17.2982%; height: 46.5625px;">String</td><td style="width: 9.01977%; height: 46.5625px;">是</td><td style="width: 33.7333%; height: 46.5625px;"><div>核销⻔店信息，核销原⽣券时需要⻔店信息</div></td><td style="width: 23.4743%; height: 46.5625px;">  
</td></tr><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;"><div>orderInfo</div></td><td style="width: 17.2982%; height: 46.5625px;">OrdeInfo</td><td style="width: 9.01977%; height: 46.5625px;">是</td><td style="width: 33.7333%; height: 46.5625px;"><div>订单信息，若该门店不支持核销则OrdeInfo为空</div></td><td style="width: 23.4743%; height: 46.5625px;">  
</td></tr><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;"> </td><td style="width: 17.2982%; height: 46.5625px;"> </td><td style="width: 9.01977%; height: 46.5625px;"> </td><td style="width: 33.7333%; height: 46.5625px;"> </td><td style="width: 23.4743%; height: 46.5625px;"> </td></tr><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;">OrdeInfo字段及含义如下</td><td style="width: 17.2982%; height: 46.5625px;"> </td><td style="width: 9.01977%; height: 46.5625px;"> </td><td style="width: 33.7333%; height: 46.5625px;"> </td><td style="width: 23.4743%; height: 46.5625px;"> </td></tr><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;"><div>orderId</div></td><td style="width: 17.2982%; height: 46.5625px;">String</td><td style="width: 9.01977%; height: 46.5625px;">是</td><td style="width: 33.7333%; height: 46.5625px;"><div>要核销的券所属订单</div></td><td style="width: 23.4743%; height: 46.5625px;"> </td></tr><tr style="height: 46.5625px;"><td style="width: 16.4333%; height: 46.5625px;">certificateId</td><td style="width: 17.2982%; height: 46.5625px;"><div>String</div></td><td style="width: 9.01977%; height: 46.5625px;">否</td><td style="width: 33.7333%; height: 46.5625px;">券信息  
• 团购券和代⾦券返回传certificate\_id  
</td><td style="width: 23.4743%; height: 46.5625px;">certificateId及timesCardInfo两者必有其一</td></tr><tr style="height: 46.25px;"><td style="width: 16.4333%; height: 46.25px;"><div>timesCardInfo</div></td><td style="width: 17.2982%; height: 46.25px;">TimesCard</td><td style="width: 9.01977%; height: 46.25px;">否</td><td style="width: 33.7333%; height: 46.25px;">券信息  
• 次卡券返回TimesCard结构</td><td style="width: 23.4743%; height: 46.25px;"> </td></tr><tr style="height: 43.9375px;"><td style="width: 16.4333%; height: 43.9375px;"> </td><td style="width: 17.2982%; height: 43.9375px;"> </td><td style="width: 9.01977%; height: 43.9375px;"> </td><td style="width: 33.7333%; height: 43.9375px;"> </td><td style="width: 23.4743%; height: 43.9375px;"> </td></tr><tr style="height: 47.5938px;"><td style="width: 16.4333%; height: 47.5938px;">TimesCard字段及含义如下</td><td style="width: 17.2982%; height: 47.5938px;"> </td><td style="width: 9.01977%; height: 47.5938px;"> </td><td style="width: 33.7333%; height: 47.5938px;"> </td><td style="width: 23.4743%; height: 47.5938px;"> </td></tr><tr style="height: 46.25px;"><td style="width: 16.4333%; height: 46.25px;"><div>code</div></td><td style="width: 17.2982%; height: 46.25px;"><div>String</div></td><td style="width: 9.01977%; height: 46.25px;">是</td><td style="width: 33.7333%; height: 46.25px;"><div>抵扣券ID，对应抖⾳原⽣团购券的certificate_id</div></td><td style="width: 23.4743%; height: 46.25px;"> </td></tr><tr style="height: 29.4583px;"><td style="width: 16.4333%; height: 29.4583px;"><div>times</div></td><td style="width: 17.2982%; height: 29.4583px;">Integer</td><td style="width: 9.01977%; height: 29.4583px;">是</td><td style="width: 33.7333%; height: 29.4583px;"><div>次卡券必填，代表可核销次数，小于等于0表示次卡已用完</div></td><td style="width: 23.4743%; height: 29.4583px;">  
</td></tr><tr style="height: 29.4583px;"><td style="width: 16.4333%; height: 29.4583px;">  
</td><td style="width: 17.2982%; height: 29.4583px;">  
</td><td style="width: 9.01977%; height: 29.4583px;">  
</td><td style="width: 33.7333%; height: 29.4583px;">  
</td><td style="width: 23.4743%; height: 29.4583px;">  
</td></tr></tbody></table>