付款码支付接口
接口名称
openapi.payment.order.swipe
请求方式
POST
请求头
application/json; charset=utf-8
请求业务参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
merchant_order_sn | string | 是 | 32 | 第三方商户订单号,确保唯一 |
type | int | 是 | 1 | 支付方式[微信1/支付宝2/银联5] |
auth_code | string | 是 | 18 | 用户支付授权码 |
total_fee | float | 是 | 10 | 订单金额(元),精确到2位小数 |
store_id | int | 否 | 10 | 门店ID,当存在多个门店时,此字段必填 |
cashier_id | int | 否 | 10 | 收银员ID |
- 请求示例:
{
"method": "openapi.payment.order.swipe",
"biz_content": "{\"store_id\":2923,\"cashier_id\":150643,\"merchant_order_sn\":\"201704261493188833017\",\"total_fee\":0.01,\"type\":1,\"auth_code\":\"130233499965960229\"}"
}
成功同步返回
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
merchant_order_sn | string | 是 | 32 | 第三方商户的订单号 |
order_sn | string | 是 | 20 | 付呗订单号 |
trade_state | string | 否 | 20 | 交易状态, USERPAYING :用户支付中; SUCCESS:交易成功 |
total_fee | float | 是 | 10 | 订单金额(元) ,精确到2位小数 |
pay_time | int | 是 | 10 | 支付时间(秒) |
Tips:trade_state 为 USERPAYING时, 需调用查询接口查询最终支付状态
响应示例:
{
"result_message": "成功",
"data": {
"merchant_order_sn": "201704261493188998124",
"order_sn": "20170426144314815793",
"total_fee": 0.01,
"pay_time": 1493188996,
"trade_state": "SUCCESS"
},
"result_code": 200
}
失败同步返回
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
merchant_order_sn | string | 是 | 32 | 第三方商户的订单号 |
- 响应示例:
{
"result_code": 400,
"data": {
"merchant_order_sn":"20160120105532871512"
}
"result_message": "失败"
}
- 提醒:当同步返回信息不能判定订单是否支付成功(网络抖动、服务器超时、返回信息异常等),须调用查询接口再次确认支付结果