二维码刷卡交易v2

业务功能

收银员使用扫码设备读取用户刷卡授权码以后,二维码或条码信息传送至商户收银台,由商户收银台或者商户后台调用该接口发起支付对用户进行收款。

交互模式

请求:后台请求交互模式

返回结果:后台请求交互模式

关于调用支付接口后相关情况的处理方案:当调用扣款接口返回未知状态,需要调用查询接口查询订单实际支付状态 。 建议 5 秒调一次查询,调用 10 次后还未成功作支付超时处理。

接口名称:/open/v2/pay

请求参数:

字段 类型 必填项 描述
sn string 设备号、虚拟设备号
outTradeId string 第三方交易流水号,不长于50位,第三方全局唯一
authCode string 付款码
tradeAmount int 交易金额(分)
payTypeId int 支付方式,0-自动判断 1003-微信 1004-支付宝 1010-银联扫码 1034-数字人民币
isSharing bool 是否可分账,可不传
subject string 商品信息
remark string 交易备注
goodsTag text 微信订单优惠标记
goodsDetail json array 商品对象数组
clientIP text 收款客户端IP
receivers array对象 分账对象:[{merchantId:平台接收人商户ID,amount:分给金额,单位分,isProcedureCustomer: 不传默认为0,如需从该商户扣除手续费,传3,仅易票联渠道支持}],isSharing为true时生效
isProcedureCustomer number 按条件 不传默认3,如不从交易商户扣除手续费传0,isSharing为true时生效,仅易票联渠道支持
enablePayChannels text 按条件 易票联渠道使用花呗分期时传pcreditpayInstallment
instalmentsNum int 按条件 仅支持分期3、6、12期
商品对象
字段 类型 必填项 描述
goodsId string 商品编号
goodsName string 商品名称
quantity int 数量
price int 单价(分)
body string 商品描述信息
showUrl string 商品的展示地址

响应:

sn string 设备号、虚拟设备号
outTradeId string 第三方交易流水号,不长于50位,第三方全局唯一
tradeAmount int 交易金额(分)
payTypeId int 支付方式
tradeId string 交易流水号
mrchntCode string 商户编号
terCode string 终端编号
mrchntName string 商户名称
status int 交易状态:0-未知 1-支付成功 2-支付失败
remark string 交易备注
channelDiscount int 渠道优惠金额(单位:分)
channelCoupon int 渠道红包金额(单位:分)
channelPoint int 渠道积分(单位:分)
merchantDiscount int 渠道商户优惠金额(单位:分)
merchantCoupon int 渠道商户红包金额(单位:分)
caseierNo string 第三方收银号,银行卡为6位凭证号,微信、支付宝为账单中的商户单号
referenceNO string 参考号,银行卡为参考号,微信、支付宝为账单中的交易单号
certificateNO string 银联凭证号
authCode string 银联授权码
batchNO string 银联批次号
paytime string 银联交易时间
openId string 微信openid,支付宝buyerid
subOpenId string 微信subOpenId