# 线下posp接口列表 # 二维码支付或兑换 **接口用途** - 支付宝支付 - 微信被扫支付 - 银行二维码支付(工行、中行、中信、浦发等) - 银行二维码积分兑换(工行、中行、中信、浦发等) - 银联立码付 - 百度支付 - 翼支付 - 其他二维码支付 - 电子凭证核销:产品券/代金券/折扣券/买N赠M券/立减券 - 外卖或自助点单订单码自动上屏 **接口地址** - `https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/qrcodeSale` **action** - `qrcodeSale` **请求参数,中件间===>易百后台**
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String(40) | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
totalAmount | Price | 是 | 交易总金额 | 单位:元 |
undiscountAmount | Price | 是 | 不可打折金额 | 单位:元 如无此金额时可填0 |
verifyType | String | 是 | 核销类型 | 请与易百技术确认,枚举值:wechatApp(微信小程序),h5,aliApp(支付宝小程序),pos(线下pos机具) |
activityProductNo | String | 否 | 活动产品编号 | 二次交互时填写 |
scene | String | 否 | 支付场景 | 条码:bar\_code, 二维码:qr\_code |
orderSubject | String | 否 | 订单标题 | 最长256 |
orderDescription | String | 否 | 订单描述 | 最长256 |
qrcode | String | 是 | 二维码内容 | 串号、一维码或二维码内容 |
goodsDetail | List<[goodsDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/goods-detail.html "goodsDetail")> | 是 | 产品明细 | 验证产品明细时必填 |
memberDetail | Object<[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")> | 否 | 会员信息 | 会员支付时必填 |
extendData | Object | 否 | 扩展信息 | 特殊场景填值需与易百技术沟通 |
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
orderNo | String | 是 | 交易订单号 | 易百生成 |
transDate | String | 是 | 交易时间 | 格式为:yyyyMMddHHmmss |
returnCode | String | 是 | 返回码 | 00表示交易成功,其他表示失败 |
returnDesc | String | 是 | 返回信息 | 交易结果描述或错误原因 |
paidAmount | Price | 是 | 支付成功总金额 | 单位:元 |
receiptAmount | Price | 否 | 商户实收金额 | 单位:元 |
invoiceAmount | Price | 否 | 商户开票金额 | 单位:元 |
exchangeRate | Number(8,6) | 否 | 汇率 | 1外币等于多少人民币 |
currency | String | 否 | 货币类型 | 例如:CNY |
discountCode | String | 否 | 折扣编码 | 由收银机分配,用于入账计折扣类型 |
discountNum | Number | 否 | 固定金额折扣数量 | 用于入账计折扣类型的数量 |
tenderCode | String | 否 | 支付方式编码 | 由收银机分配,用于入账计支付方式 |
remainTimes | Number | 是 | 券码当前可用次数 | 如果有限制每天使用多少次,代表当天可使用次数 |
activityProductNo | String | 否 | 活动产品编号 | |
activityProductName | String | 否 | 活动产品名称 | |
goodsDetail | List<[goodsDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/goods-detail.html "goodsDetail")> | 否 | 折抵产品明细 | 返回后台已抵扣成功的产品明细 |
fundChannel | List<[fundChannel](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/fund-channel.html "fundChannel")> | 否 | 资金渠道 | |
printDetail | Object<[printDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/print-detail.html "printDetail")> | 否 | 打印信息 | 如需要在收银小票上打印信息时必填 |
memberDetail | Object<[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")> | 否 | 会员信息 | 返回本次交易的会员信息 |
voucherDetail | List<[voucherDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/voucher-detail.html "voucherDetail")> | 否 | 优惠券信息 | 返回本次交易的优惠券信息 |
extendsData | Object<[extendsData](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/extends-data.html "extendsData")> | 否 | 扩展信息 | 与ebuy约定 |
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
originalTraceNo | String | 是 | 原收银机流水号 | 传入需要查询的原交易收银机流水号 |
isRollback | Boolean | 是 | 标识本次请求是否为冲正交易(中间件发起) | 冲正发起需要另起线程并且先返回收银机交易失败结果,再异步冲正 |
acquirer | String | 否 | 收单机构 | 如:citicCashpay表示中信收单,如果收单撤销是必填的 |
cardInfo | Object<[cardInfo](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/card-info.html "cardInfo")> | 否 | 卡信息 | 卡支付类交易需要填入原交易卡信息 |
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
orderNo | String | 是 | 交易订单号 | |
transDate | String | 是 | 交易时间 | 格式为:yyyyMMddHHmmss |
returnCode | String | 是 | 返回码 | 00表示交易成功,其他表示失败 |
returnDesc | String | 是 | 返回信息 | 交易结果描述或错误原因 |
fundChannel | List<[fundChannel](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/fund-channel.html "fundChannel")> | 否 | 资金渠道 | |
printDetail | Object<[printDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/print-detail.html "printDetail")> | 否 | 打印信息 | 如需要在收银小票上打印信息时必填 |
memberDetail | Object<[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")> | 否 | 会员信息 | 返回本次交易的会员信息 |
voucherDetail | List<[voucherDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/voucher-detail.html "voucherDetail")> | 否 | 优惠券信息 | 返回本次交易的优惠券信息 |
cashOrderNo | String | 否 | 收单原流水号 | 收单撤销时返回 |
cashBank | String | 否 | 收单机构标识 | 收单撤销时返回 |
purchaseOrder | List<[purchaseOrder](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/qian-gou-dan-xin-xi.html)> | 否 | 收单签购单信息 | [签购单信息](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/qian-gou-dan-xin-xi.html) |
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
originalTraceNo | String | 是 | 原收银机流水号 | 传入需要查询的原交易收银机流水号 |
originalDate | String | 否 | 原交易日期 | 传入需要查询的原交易日期,不传默认为当天格式为yyyyMMdd |
字段 | 类型 | 是否必填 | 字段意义 | 备注 |
---|---|---|---|---|
traceNo | String | 是 | 收银机流水号 | 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列 |
orderNo | String | 是 | 交易订单号 | 单位:元 |
transDate | String | 是 | 交易时间 | 格式为:yyyyMMddHHmmss |
returnCode | String | 是 | 返回码 | 00表示交易成功,其他表示失败 |
returnDesc | String | 是 | 返回信息 | 交易结果描述或错误原因 |
paidAmount | Price | 是 | 支付成功总金额 | 单位:元 |
receiptAmount | Price | 否 | 商户实收金额 | 单位:元 |
invoiceAmount | Price | 否 | 商户开票金额 | 单位:元 |
exchangeRate | Number(8,6) | 否 | 汇率 | 1外币等于多少人民币 |
currency | String | 否 | 货币类型 | 例如:CNY |
discountCode | String | 否 | 折扣编码 | 由收银机分配,用于入账计折扣类型 |
discountNum | Number | 否 | 固定金额折扣数量 | 用于入账计折扣类型的数量 |
tenderCode | String | 否 | 支付方式编码 | 由收银机分配,用于入账计支付方式 |
activityProductNo | String | 否 | 活动产品编号 | |
activityProductName | String | 否 | 活动产品名称 | |
needSameCard | Boolean | 否 | 同一张卡支付 | 如满额立减类活动,需要同一张银行卡支付剩余金额 |
goodsDetail | List<[goodsDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/goods-detail.html "goodsDetail")> | 否 | 折抵产品明细 | 返回后台已抵扣成功的产品明细 |
fundChannel | List<[fundChannel](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/fund-channel.html "fundChannel")> | 否 | 资金渠道 | |
printDetail | Object<[printDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/print-detail.html "printDetail")> | 否 | 打印信息 | 如需要在收银小票上打印信息时必填 |
memberDetail | Object<[memberDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/member-detail.html "memberDetail")> | 否 | 会员信息 | 返回本次交易的会员信息 |
voucherDetail | List<[voucherDetail](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/voucher-detail.html "voucherDetail")> | 否 | 优惠券信息 | 返回本次交易的优惠券信息 |
extendsData | Object<[extendsData](https://gitbook.e-fuli.com/ebuy-cashier-integration-api/cn/api-introduction/parameter-object/extends-data.html "extendsData")> | 否 | 扩展信息 | 与ebuy约定 |