二维码刷卡交易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时生效,仅易票联渠道有效
splitNotifyUrl text 否 分账结果后台通知地址,仅isSharing为true时有效
splitRemarks text 否 分账备注,仅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
cardType string 卡类型,1:借记卡,2:贷记卡:5:零钱,仅部分渠道返回
upMchtNo string 上游渠道商户号(微信,支付宝商户号),仅部分渠道返回