业务功能
收银员使用扫码设备读取用户刷卡授权码以后,二维码或条码信息传送至商户收银台,由商户收银台或者商户后台调用该接口发起支付对用户进行收款。
交互模式
请求:后台请求交互模式
返回结果:后台请求交互模式
关于调用支付接口后相关情况的处理方案:当调用扣款接口返回未知状态,需要调用查询接口查询订单实际支付状态 。 建议 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 |
isProcedureCustomer | number | 按条件 | 不传默认3,如不从交易商户扣除手续费传0,isSharing为true时生效 |
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 |