# 二维码支付或兑换

<div id="bkmrk-%E6%8E%A5%E5%8F%A3%E7%94%A8%E9%80%94"><div>**接口用途**</div></div><div id="bkmrk-%E6%94%AF%E4%BB%98%E5%AE%9D%E6%94%AF%E4%BB%98-%E5%BE%AE%E4%BF%A1%E8%A2%AB%E6%89%AB%E6%94%AF%E4%BB%98-%E9%93%B6%E8%A1%8C%E4%BA%8C%E7%BB%B4%E7%A0%81%E6%94%AF%E4%BB%98"><div><div><div><div>- 支付宝支付
- 微信被扫支付
- 银行二维码支付(工行、中行、中信、浦发等)
- 银行二维码积分兑换(工行、中行、中信、浦发等)
- 银联立码付
- 百度支付
- 翼支付
- 其他二维码支付
- 电子凭证核销：产品券/代金券/折扣券/买N赠M券/立减券
- 外卖或自助点单订单码自动上屏

</div></div></div></div></div>### **接口地址**

<div id="bkmrk-https%3A%2F%2Febuywebposp-"><div><div><div><div>- `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/qrcodeSale`

</div></div></div></div></div>### **action**

<div id="bkmrk-qrcodesale"><div><div><div><div>- `qrcodeSale`

</div></div></div></div></div>**请求参数，中件间===&gt;易百后台**

<div 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"><table style="width: 809px; height: 440px;"><thead><tr style="height: 46px;"><th style="width: 139px; height: 46px;">字段</th><th style="width: 167px; height: 46px;">类型</th><th style="width: 59px; height: 46px;">是否必填</th><th style="width: 113px; height: 46px;">字段意义</th><th style="width: 331px; height: 46px;">备注</th></tr></thead><tbody><tr style="height: 46px;"><td style="width: 139px; height: 46px;">traceNo</td><td style="width: 167px; height: 46px;">String(40)</td><td style="width: 59px; height: 46px;">是</td><td style="width: 113px; height: 46px;">收银机流水号</td><td style="width: 331px; height: 46px;">不允许重复，必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr><td style="width: 139px;">onlineTid</td><td style="width: 167px;">String</td><td style="width: 59px;">否</td><td style="width: 113px;">线上对接使用的统一终端号</td><td style="width: 331px;">对接前需提前和易百技术沟通</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">totalAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 59px; height: 29px;">是</td><td style="width: 113px; height: 29px;">交易总金额</td><td style="width: 331px; height: 29px;">单位：元</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">undiscountAmount</td><td style="width: 167px; height: 29px;">Price</td><td style="width: 59px; height: 29px;">是</td><td style="width: 113px; height: 29px;">不可打折金额</td><td style="width: 331px; height: 29px;">单位：元 如无此金额时可填0</td></tr><tr style="height: 46px;"><td style="width: 139px; height: 46px;">verifyType</td><td style="width: 167px; height: 46px;">String</td><td style="width: 59px; height: 46px;">是</td><td style="width: 113px; height: 46px;">核销类型</td><td style="width: 331px; height: 46px;">请与易百技术确认，枚举值：online为线上场景，offline为线下POS场景</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">activityProductNo</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">活动产品编号</td><td style="width: 331px; height: 29px;">二次交互时填写</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">scene</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">支付场景</td><td style="width: 331px; height: 29px;">条码:bar\_code, 二维码:qr\_code</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">orderSubject</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">订单标题</td><td style="width: 331px; height: 29px;">最长256</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">orderDescription</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">订单描述</td><td style="width: 331px; height: 29px;">最长256</td></tr><tr><td style="width: 139px;">merchantOrderNo</td><td style="width: 167px;">String(30)</td><td style="width: 59px;">是</td><td style="width: 113px;">商户收银订单号</td><td style="width: 331px;">用于当笔交易对应到收银POS的订单，不能与traceNo值相同</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">qrcode</td><td style="width: 167px; height: 29px;">String</td><td style="width: 59px; height: 29px;">是</td><td style="width: 113px; height: 29px;">二维码内容</td><td style="width: 331px; height: 29px;">串号、一维码或二维码内容</td></tr><tr style="height: 35px;"><td style="width: 139px; height: 35px;">goodsDetail</td><td style="width: 167px; height: 35px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 59px; height: 35px;">是</td><td style="width: 113px; height: 35px;">产品明细</td><td style="width: 331px; height: 35px;">验证产品明细时必填</td></tr><tr style="height: 35px;"><td style="width: 139px; height: 35px;">memberDetail</td><td style="width: 167px; height: 35px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 59px; height: 35px;">否</td><td style="width: 113px; height: 35px;">会员信息</td><td style="width: 331px; height: 35px;">会员支付时必填</td></tr><tr style="height: 29px;"><td style="width: 139px; height: 29px;">extendData</td><td style="width: 167px; height: 29px;">Object</td><td style="width: 59px; height: 29px;">否</td><td style="width: 113px; height: 29px;">扩展信息</td><td style="width: 331px; height: 29px;">特殊场景填值需与易百技术沟通</td></tr></tbody></table>

</div>### **请求报文举例**

```JSON
{
  "traceNo": "990000091000101620150201",
  "totalAmount": 40.8,
  "undiscountAmount": 0,
  "activityProductNo": "HDCP00000000001234",
  "qrcode": "280123121234567890",
  "goodsDetail": [
    {
      "goodsCategory": "001",
      "goodsId": "P00001",
      "goodsName": "牙膏",
      "price": 8,
      "quantity": 2,
      "rebateCode": "000"
    },
    {
      "goodsCategory": "101",
      "goodsId": "P00002",
      "goodsName": "洗发水",
      "price": 24.8,
      "quantity": 1,
      "rebateCode": "000"
    }
  ],
  "memberDetail": {
    "memberId": "M000001545",
    "memberName": "TONY",
    "grade": "1",
    "status": "1",
    "balance": 1000,
    "pointBalance": 30000
  },
  "extendData": {
    "orderId": "20211000101620150201",
    "rightsDetail": [
      {
        "snCode": "111111111xxxxxx"
      }
    ]
  }
}
```

**返回参数，易百后台===&gt;中件间**

<div id="bkmrk-%E5%8F%AF%E8%83%BD%E8%BF%94%E5%9B%9E%E6%B4%BB%E5%8A%A8%E4%BA%A7%E5%93%81%E9%80%89%E9%A1%B9%EF%BC%8C%E9%9C%80%E8%A6%81%E8%BF%9B%E8%A1%8C%E9%80%89%E6%8B%A9-%E5%AD%97%E6%AE%B5">- 可能返回[活动产品选项](https://book.e-buy.com/books/e-buy-B6z/page/5b8ad-xEt "活动产品选项")，需要进行选择

<table style="width: 99.7531%; height: 799.079px;"><thead><tr style="height: 46.5938px;"><th style="width: 18.0917%; height: 46.5938px;">字段</th><th style="width: 20.57%; height: 46.5938px;">类型</th><th style="width: 6.81537%; height: 46.5938px;">是否必填</th><th style="width: 15.9851%; height: 46.5938px;">字段意义</th><th style="width: 38.5378%; height: 46.5938px;">备注</th></tr></thead><tbody><tr style="height: 46.5938px;"><td style="width: 18.0917%; height: 46.5938px;">traceNo</td><td style="width: 20.57%; height: 46.5938px;">String</td><td style="width: 6.81537%; height: 46.5938px;">是</td><td style="width: 15.9851%; height: 46.5938px;">收银机流水号</td><td style="width: 38.5378%; height: 46.5938px;">不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">orderNo</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">交易订单号</td><td style="width: 38.5378%; height: 29.7969px;">易百生成</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">transDate</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">交易时间</td><td style="width: 38.5378%; height: 29.7969px;">格式为：yyyyMMddHHmmss</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">returnCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">返回码</td><td style="width: 38.5378%; height: 29.7969px;">00表示交易成功，其他表示失败</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">returnDesc</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">返回信息</td><td style="width: 38.5378%; height: 29.7969px;">交易结果描述或错误原因</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">paidAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">是</td><td style="width: 15.9851%; height: 29.7969px;">支付成功总金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">receiptAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">商户实收金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">invoiceAmount</td><td style="width: 20.57%; height: 29.7969px;">Price</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">商户开票金额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">exchangeRate</td><td style="width: 20.57%; height: 29.7969px;">Number(8,6)</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">汇率</td><td style="width: 38.5378%; height: 29.7969px;">1外币等于多少人民币</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">currency</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">货币类型</td><td style="width: 38.5378%; height: 29.7969px;">例如:CNY</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">discountCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">折扣编码</td><td style="width: 38.5378%; height: 29.7969px;">由收银机分配，用于入账计折扣类型</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">discountNum</td><td style="width: 20.57%; height: 29.7969px;">Number</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">固定金额折扣数量</td><td style="width: 38.5378%; height: 29.7969px;">用于入账计折扣类型的数量</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">tenderCode</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">支付方式编码</td><td style="width: 38.5378%; height: 29.7969px;">由收银机分配，用于入账计支付方式</td></tr><tr style="height: 46.5938px;"><td style="width: 18.0917%; height: 46.5938px;">remainTimes</td><td style="width: 20.57%; height: 46.5938px;">Number</td><td style="width: 6.81537%; height: 46.5938px;">是</td><td style="width: 15.9851%; height: 46.5938px;">券码当前可用次数</td><td style="width: 38.5378%; height: 46.5938px;">如果有限制每天使用多少次，代表当天可使用次数</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">activityProductNo</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">活动产品编号</td><td style="width: 38.5378%; height: 29.7969px;">  
</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">activityProductName</td><td style="width: 20.57%; height: 29.7969px;">String</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">活动产品名称</td><td style="width: 38.5378%; height: 29.7969px;">  
</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">goodsDetail</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[goodsDetail](https://book.e-buy.com/books/e-buy-B6z/page/3def1 "goodsDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">折抵产品明细</td><td style="width: 38.5378%; height: 35.3906px;">返回后台已抵扣成功的产品明细</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">fundChannel</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[fundChannel](https://book.e-buy.com/books/e-buy-B6z/page/14bfa "fundChannel")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">资金渠道</td><td style="width: 38.5378%; height: 35.3906px;">  
</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">printDetail</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[printDetail](https://book.e-buy.com/books/e-buy-B6z/page/eed5a "printDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">打印信息</td><td style="width: 38.5378%; height: 35.3906px;">如需要在收银小票上打印信息时必填</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">memberDetail</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[memberDetail](https://book.e-buy.com/books/e-buy-B6z/page/9fc3d "memberDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">会员信息</td><td style="width: 38.5378%; height: 35.3906px;">返回本次交易的会员信息</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">voucherDetail</td><td style="width: 20.57%; height: 35.3906px;">List&lt;[voucherDetail](https://book.e-buy.com/books/e-buy-B6z/page/8f855 "voucherDetail")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">优惠券信息</td><td style="width: 38.5378%; height: 35.3906px;">返回本次交易的优惠券信息</td></tr><tr style="height: 29.7969px;"><td style="width: 18.0917%; height: 29.7969px;">remainAmount</td><td style="width: 20.57%; height: 29.7969px;">Number</td><td style="width: 6.81537%; height: 29.7969px;">否</td><td style="width: 15.9851%; height: 29.7969px;">消费后卡余额</td><td style="width: 38.5378%; height: 29.7969px;">单位：元</td></tr><tr style="height: 35.3906px;"><td style="width: 18.0917%; height: 35.3906px;">extendsData</td><td style="width: 20.57%; height: 35.3906px;">Object&lt;[extendsData](https://book.e-buy.com/books/e-buy-B6z/page/06905 "extendsData")&gt;</td><td style="width: 6.81537%; height: 35.3906px;">否</td><td style="width: 15.9851%; height: 35.3906px;">扩展信息</td><td style="width: 38.5378%; height: 35.3906px;">与ebuy约定</td></tr><tr><td style="width: 18.0917%;">transType</td><td style="width: 20.57%;">String</td><td style="width: 6.81537%;">是</td><td style="width: 15.9851%;">标识当笔交易类型</td><td style="width: 38.5378%;">下发alipayQrpay 表示 支付宝二维码支付业务</td></tr></tbody></table>

</div>### **返回报文举例**

```JSON
{
  "traceNo": "9900000910001011720150201",
  "orderNo": "171698602301",
  "transDate": "20161231120533",
  "returnCode": "00",
  "returnDesc": "SUCCESS",
  "paidAmount": 40.8,
  "receiptAmount": 40.8,
  "invoiceAmount": 40.8,
  "exchangeRate": 6.0939,
  "currency": "CNY",
  "discountCode": "0001",
  "discountNum": 20,
  "tenderCode": "8001",
  "activityProductNo": "2016123102",
  "activityProductName": "支付宝支付",
  "transType": "alipayQrpay",
  "goodsDetail": [
    {
      "goodsCategory": "001",
      "goodsId": "P00001",
      "goodsName": "牙膏",
      "price": 8,
      "quantity": 2,
      "rebateCode": "000",
      "activityNo": "2016123101",
      "memo": "100123456789"
    },
    {
      "goodsCategory": "101",
      "goodsId": "P00002",
      "goodsName": "洗发水",
      "price": 24.8,
      "quantity": 1,
      "rebateCode": "000",
      "activityNo": "2016123101",
      "memo": "100123456789"
    }
  ],
  "fundChannel": [
    {
      "channelNo": "001",
      "channelName": "用户实付现金",
      "channelAmount": "20.8"
    },
    {
      "channelNo": "002",
      "channelName": "用户积分支付",
      "channelAmount": "20"
    }
  ],
  "printDetail": {
    "cardNo64": "622562****8888",
    "bank": "中国银行",
    "paymentOrderNo": "201612315689412157458787",
    "paymentUser": "139****@163.com",
    "pointSale": "20000",
    "qrCode1": "htt://www.api-location-url.com/url",
    "qrCode2": "",
    "qrCode3": "",
    "barCode1": "12345679",
    "barCode2": "",
    "barCode3": ""
  },
  "memberDetail": {
    "memberId": "M000001545",
    "memberName": "TONY",
    "grade": "1",
    "status": "1",
    "balance": 1000,
    "pointBalance": 30000
  },
  "voucherDetail": [
    {
      "voucherId": "001",
      "voucherName": "现金优惠券",
      "voucherType": "现金",
      "voucherCode": "123456789",
      "channelAmount": "20.8"
    },
    {
      "voucherId": "002",
      "voucherName": "买一赠一优惠券",
      "voucherType": "买赠",
      "voucherCode": "1232136781",
      "channelAmount": "20.8"
    }
  ]
}
```