关于调用支付接口后相关情况的处理方案:当调用扣款接口返回未知状态,需要调用查询接口查询订单实际支付状态 。 建议 5 秒调一次查询,调用 10 次后还未成功作支付超时处理。
| 接口名称:/open/facepay/pay |
|---|
请求参数:
| 字段 | 类型 | 必填项 | 描述 |
| sn | string | 是 | 设备号、虚拟设备号 |
| tradeId | string | 是 | 获取交易流水接口返回;根据场景,获取交易流水接口可以不调,tradeId为空时,outTradeId、tradeAmount必传 |
| faceCode | string | 是 | 付款码 |
| payTypeId | int | 是 | 支付方式,0-自动判断 1003-微信 1004-支付宝 1010-全渠道扫码 1026-银联扫码 |
| subject | string | 否 | 描述 |
| openId | string | 是 | 微信openId |
| outTradeId | string | 是 | 第三方交易流水号,不长于50位,第三方全局唯一(tradeId,outTradeId,必传其一) |
| tradeAmount | int | 是 | 交易金额(分),(tradeId为空时,必传) |
| remark | string | 否 | 交易备注 |
响应:
| sn | string | 设备号、虚拟设备号 | |
| tradeId | string | 平台流水号 | |
| tradeAmount | int | 交易金额(分) | |
| payTypeId | int | 支付方式 | |
| mrchntCode | string | 商户编号 | |
| terCode | string | 是 | 终端编号 |
| mrchntName | string | 商户名称 | |
| status | int | 交易状态:0-未知 1-支付成功 2-支付失败 | |
| caseierNo | string | 第三方收银号,银行卡为6位凭证号,微信、支付宝为账单中的商户单号 | |
| payTime | string | 支付时间 | |
| channelDiscount | int | 渠道优惠金额(单位:分) | |
| channelCoupon | int | 渠道红包金额(单位:分) | |
| channelPoint | int | 渠道积分(单位:分) | |
| merchantDiscount | int | 渠道商户优惠金额(单位:分) | |
| merchantCoupon | int | 渠道商户红包金额(单位:分) | |
| openId | string | 微信支付为openId,支付宝为BuyerUserId | |
| subOpenId | string | 微信支付subOpenId,支付宝为子商户BuyerUserId |