刷卡支付接口
接口名称
openapi.payment.order.swipe
请求方式
POST
请求业务参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| merchant_order_sn | string | 是 | 32 | 第三方商户订单号,确保唯一 |
| type | int | 是 | 1 | 支付方式[微信1/支付宝2] |
| auth_code | string | 是 | 18 | 用户支付授权码 |
| total_fee | float | 是 | 10 | 订单金额(元) |
| store_id | int | 可选 | 10 | 门店ID,当存在多个门店时,此字段必填 |
| cashier_id | int | 可选 | 10 | 收银员ID |
| device_no | string | 可选 | 18 | 设备终端号 |
| body | string | 否 | 128 | 对交易或商品的描述(微信上body值显示在商品,支付宝上body值显示在商品说明) |
| call_back_url | string | 可选 | 256 | 支付成功后回调链接 |
- 请求示例:
{
"app_id": "20161219113441561987",
"method": "openapi.payment.order.swipe",
"format": "json",
"sign_method": "md5",
"sign": "5F0EA68A1278C0F7A524073D2B498C43",
"nonce": "pp2kiwi",
"version": "1.0",
"biz_content": "{\"store_id\":25249,\"cashier_id\":151156,\"merchant_order_sn\":\"201704191492587335309\",\"total_fee\":0.01,\"type\":1,\"auth_code\":\"130784921069830971\"}"
}
成功响应参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| merchant_order_sn | string | 是 | 32 | 第三方商户的订单号 |
| order_sn | string | 是 | 20 | 生活圈订单号 |
| trade_state | string | 否 | 20 | 交易状态, USERPAYING :用户支付中; SUCCESS:交易成功 |
| total_fee | float | 是 | 10 | 订单金额(元) |
| pay_time | int | 是 | 10 | 支付时间(秒) |
Tips:trade_state 为 USERPAYING时, 需调用查询接口查询最终支付状态
响应示例:
{
"result_code": 200,
"data": {
"merchant_order_sn":"20160120105532871512",
"order_sn":"20160119233754227705",
"trade_state":"USERPAYING"
"total_fee":99.00,
"pay_time":1478574762,
},
"result_message": "成功"
}
失败响应参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| merchant_order_sn | string | 是 | 32 | 第三方商户的订单号 |
- 响应示例:
{
"result_code": 400,
"data": {
"merchant_order_sn":"20160120105532871512"
}
"result_message": "失败"
}
- 提醒:当同步返回信息不能判定订单是否支付成功(网络抖动、服务器超时、返回信息异常等),须调用查询接口再次确认支付结果