# 业务参数对象



# 产品明细

- 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>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></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></tr></tbody></table>

- 支持的资金渠道如下：

<table id="bkmrk-channelno-channelnam"><thead><tr><th>channelNo</th><th>channelName</th><th>字段意义</th></tr></thead><tbody><tr><td>user\_real\_money</td><td>用户实际支付</td><td>如支付宝余额、余额宝、微信钱包余额、银行卡等</td></tr><tr><td>user\_balance</td><td>用户余额支付</td><td>如支付宝余额、余额宝、微信钱包余额等</td></tr><tr><td>user\_bank\_card</td><td>用户银行卡余额</td><td>使用用户借记卡或贷记卡的余额进行支付</td></tr><tr><td>user\_credit</td><td>用户信用支付</td><td>如支付宝花呗、京东白条等</td></tr><tr><td>user\_points</td><td>用户积分支付</td><td>如银行积分、天猫积分、集分宝等</td></tr><tr><td>merchant\_benefit</td><td>商户提供的优惠</td><td>如商户空券，商户折扣等</td></tr><tr><td>platform\_benefit</td><td>平台提供的优惠</td><td>如平台折扣，平台补贴等</td></tr><tr><td>ebuy\_benefit</td><td>易百提供的优惠</td><td>如易百折扣，易百补贴等</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 style="width: 141px;">字段</th><th style="width: 80px;">类型</th><th style="width: 83px;">是否必填</th><th style="width: 112px;">字段意义</th><th style="width: 364px;">备注</th></tr></thead><tbody><tr><td style="width: 141px;">cardNo64</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">卡号前六后四</td><td style="width: 364px;">返回需要打印的卡号前六后四</td></tr><tr><td style="width: 141px;">bank</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">发卡银行</td><td style="width: 364px;">返回需要打印的发卡银行</td></tr><tr><td style="width: 141px;">paymentOrderNo</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">机构订单号</td><td style="width: 364px;">返回需要打印的机构订单号</td></tr><tr><td style="width: 141px;">paymentUser</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">机构用户账号</td><td style="width: 364px;">返回需要打印的机构用户账号</td></tr><tr><td style="width: 141px;">pointSale</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">扣除积分</td><td style="width: 364px;">返回需要打印的扣除积分数量</td></tr><tr><td style="width: 141px;">qrCode1</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印二维码1</td><td style="width: 364px;">返回需要打印的二维码1</td></tr><tr><td style="width: 141px;">qrCode2</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印二维码2</td><td style="width: 364px;">返回需要打印的二维码2</td></tr><tr><td style="width: 141px;">qrCode3</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印二维码3</td><td style="width: 364px;">返回需要打印的二维码3</td></tr><tr><td style="width: 141px;">barCode1</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印条码1</td><td style="width: 364px;">返回需要打印的条码内容1</td></tr><tr><td style="width: 141px;">barCode2</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印条码2</td><td style="width: 364px;">返回需要打印的条码内容2</td></tr><tr><td style="width: 141px;">barCode3</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印条码3</td><td style="width: 364px;">返回需要打印的条码内容3</td></tr><tr><td style="width: 141px;">content</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印内容</td><td style="width: 364px;">返回需要打印的内容，[TLV](https://gitbook.e-fuli.com/ebuy-cashier-middleware-api/cn/GLOSSARY.html#tlv "通讯协议中常用的数据格式，由标签（Tag），长度（Length），值（Value）三部分构成")格式，1F为小票title，2F为小票交易类型说明显示</td></tr><tr><td style="width: 141px;">printMode</td><td style="width: 80px;">String</td><td style="width: 83px;">否</td><td style="width: 112px;">打印联数</td><td style="width: 364px;">1表示一联，2表示两联，3表示三联</td><td style="width: 29px;">\_\_</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" style="width: 703px;"><thead><tr><th style="width: 155px;">字段</th><th style="width: 127px;">类型</th><th style="width: 94px;">是否必填</th><th style="width: 167px;">字段意义</th><th style="width: 160px;">备注</th></tr></thead><tbody><tr><td style="width: 155px;">memberId</td><td style="width: 127px;">String</td><td style="width: 94px;">是</td><td style="width: 167px;">会员ID</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">memberCode</td><td style="width: 127px;">String</td><td style="width: 94px;">是</td><td style="width: 167px;">会员编号</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">memberName</td><td style="width: 127px;">String</td><td style="width: 94px;">是</td><td style="width: 167px;">会员名称</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">memberPhone</td><td style="width: 127px;">String</td><td style="width: 94px;">否</td><td style="width: 167px;">会员手机号码</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">grade</td><td style="width: 127px;">String</td><td style="width: 94px;">否</td><td style="width: 167px;">会员等级</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">status</td><td style="width: 127px;">String</td><td style="width: 94px;">否</td><td style="width: 167px;">会员状态</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">balance</td><td style="width: 127px;">Price</td><td style="width: 94px;">否</td><td style="width: 167px;">会员卡余额</td><td style="width: 160px;"> </td></tr><tr><td style="width: 155px;">pointBalance</td><td style="width: 127px;">Price</td><td style="width: 94px;">否</td><td style="width: 167px;">会员积分余额</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" style="width: 636px;"><thead><tr><th style="width: 165px;">字段</th><th style="width: 118px;">类型</th><th style="width: 90px;">是否必填</th><th style="width: 142px;">字段意义</th><th style="width: 121px;">备注</th></tr></thead><tbody><tr><td style="width: 165px;">activityNo</td><td style="width: 118px;">String</td><td style="width: 90px;">是</td><td style="width: 142px;">活动编号</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">activityName</td><td style="width: 118px;">String</td><td style="width: 90px;">是</td><td style="width: 142px;">活动名称</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">productName</td><td style="width: 118px;">String</td><td style="width: 90px;">是</td><td style="width: 142px;">产品名称</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">customer</td><td style="width: 118px;">String</td><td style="width: 90px;">是</td><td style="width: 142px;">结算客户</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">isRefund</td><td style="width: 118px;">Boolean</td><td style="width: 90px;">是</td><td style="width: 142px;">是否为退款</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">volume</td><td style="width: 118px;">Integer</td><td style="width: 90px;">是</td><td style="width: 142px;">交易笔数</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">totalReceiptAmount</td><td style="width: 118px;">Price</td><td style="width: 90px;">是</td><td style="width: 142px;">商户实收金额</td><td style="width: 121px;"> </td></tr><tr><td style="width: 165px;">totalAmount</td><td style="width: 118px;">Price</td><td style="width: 90px;">是</td><td style="width: 142px;">小计金额</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> </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为`paymentExtra`，必填

<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: 106px;">字段</th><th style="width: 76px;">类型</th><th style="width: 94px;">是否必填</th><th style="width: 132px;">字段意义</th><th style="width: 401px;">备注</th></tr></thead><tbody><tr><td style="width: 106px;">acqId</td><td style="width: 76px;">String</td><td style="width: 94px;">是</td><td style="width: 132px;">收单机构标识码</td><td style="width: 401px;"> </td></tr><tr><td style="width: 106px;">issuerId</td><td style="width: 76px;">String</td><td style="width: 94px;">是</td><td style="width: 132px;">发卡机构标识码</td><td style="width: 401px;"> </td></tr><tr><td style="width: 106px;">cardType</td><td style="width: 76px;">String</td><td style="width: 94px;">是</td><td style="width: 132px;">卡类型</td><td style="width: 401px;">0001贷记卡,0002借记卡,0003准贷记卡,0000其它</td></tr><tr><td style="width: 106px;">cardOrgan</td><td style="width: 76px;">String</td><td style="width: 94px;">是</td><td style="width: 132px;">卡类别</td><td style="width: 401px;">true外卡，false内卡</td></tr><tr><td style="width: 106px;">pan</td><td style="width: 76px;">String</td><td style="width: 94px;">是</td><td style="width: 132px;">卡号</td><td style="width: 401px;">脱敏卡号格式：622562\*\*\*\*8888</td></tr><tr><td style="width: 106px;">aid</td><td style="width: 76px;">String</td><td style="width: 94px;">否</td><td style="width: 132px;">应用标识</td><td style="width: 401px;">通过aid来判断卡类型（VISA/MASTER/...）,在没有返回aid字段的情况下，可以通过pan卡号字段中的卡BIN来判断卡类型</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: 675px;"><thead><tr><th style="width: 141px;">字段</th><th style="width: 92px;">类型</th><th style="width: 92px;">是否必填</th><th style="width: 111px;">字段意义</th><th style="width: 239px;">备注</th></tr></thead><tbody><tr><td style="width: 141px;">voucherId</td><td style="width: 92px;">String</td><td style="width: 92px;">是</td><td style="width: 111px;">优惠券编号</td><td style="width: 239px;"> </td></tr><tr><td style="width: 141px;">voucherName</td><td style="width: 92px;">String</td><td style="width: 92px;">是</td><td style="width: 111px;">优惠券名称</td><td style="width: 239px;">用于报表、小票等显示</td></tr><tr><td style="width: 141px;">voucherType</td><td style="width: 92px;">String</td><td style="width: 92px;">是</td><td style="width: 111px;">优惠券类型</td></tr><tr><td style="width: 141px;">voucherAmount</td><td style="width: 92px;">Price</td><td style="width: 92px;">是</td><td style="width: 111px;">单价</td><td style="width: 239px;">单位：元</td></tr><tr><td style="width: 141px;">voucherCode</td><td style="width: 92px;">String</td><td style="width: 92px;">是</td><td style="width: 111px;">优惠券串号</td></tr></tbody></table>