API清单
| 编号 |
API名称 |
请求路径 |
请求方法 |
版本 |
| 1 |
支付成功回调 |
/v1/iot/parkinglot/iot-payment/callback |
POST |
v1.0.0 |
| 2 |
由 code 换取微信access_token |
/v1/iot/parkinglot/iot-payment/wechat/grant |
POST |
v1.0.0 |
| 3 |
微信统一下单接口 |
/v1/iot/parkinglot/iot-payment/wechat/pay/unifyOrder |
POST |
v1.0.0 |
| 4 |
微信订单查询接口 |
/v1/iot/parkinglot/iot-payment/wechat/pay/resultQuery |
POST |
v1.0.0 |
1.支付成功回调
请求路径
*POST /v1/iot/parkinglot/iot-payment/callback
请求参数
| 字段 |
是否必须 |
字段类型 |
描述 |
备注 |
| out_trade_no |
是 |
string |
平台订单号 |
|
| business_order_id |
是 |
string |
第三方业务系统 订单ID |
|
| transaction_id |
是 |
string |
微信交易流水ID |
返回参数
{
"code": "000000",
"msg": "请求成功",
"data": {},
"status": 200
}
2.由 code 换取微信access_token
请求路径
*POST /v1/iot/parkinglot/iot-payment/wechat/grant
请求参数
| 字段 |
是否必须 |
字段类型 |
描述 |
备注 |
| code |
是 |
string |
调用微信公众号授权后，返回的code |
|
| space_id |
是 |
string |
车场ID， 主数据空间表的主键ID |
|
| authen_type |
是 |
string |
wechat：微信公众号；alipay：支付宝生活号；wechat_mini：微信小程序 |
部分响应参数说明
| 字段 |
是否必须 |
字段类型 |
描述 |
备注 |
| openid |
是 |
string |
调用微信公众号授权后openid |
|
| unionid |
是 |
string |
调用微信公众号授权后unionid |
返回参数
{
"code": "000000",
"msg": "请求成功",
"data": {
"openid":"o6Cx46ISmbJ1oWL8-_KS7YWev7RQ",
"nickname":"鹏哥",
"headimgurl":"https:\/\/thirdwx.qlogo.cn\/mmopen\/vi_32\/HkUibecHmjWIpYtGZAq0M3TbUFXibLkVyH6AGxibQT14kE6IIM4wH0ic9w54zwz6A6DWoM21YYpYheDqwlkbwZyKwA\/132",
"privilege":[],
"unionid":"oEIwe55PabJu_9X0ThpIiKVHi5kI",
},
"status": 200
}
3.微信统一下单接口
请求路径
*POST /v1/iot/parkinglot/iot-payment/wechat/pay/unifyOrder
请求参数
| 字段 |
是否必须 |
字段类型 |
描述 |
备注 |
| openid |
是 |
string |
调用微信公众号授权后openid |
|
| total_fee |
是 |
string |
以分为单位,RMB分 |
|
| quantity |
否 |
float |
商品数量；小数。兼容更多后期业务场景。 |
|
| item_price |
否 |
float |
商品单价：保留两位小数。单位为RMB元；兼容更多后期业务场景。 |
|
| business_order_id |
否 |
string |
车场业务订单ID |
部分响应参数说明
| 字段 |
是否必须 |
字段类型 |
描述 |
备注 |
| nonce_str |
是 |
string |
生成签名的随机串 |
|
| out_trade_no |
是 |
string |
平台生成的唯一订单号 ，此订单号同步给微信 |
|
| total_fee |
是 |
string |
付款总额 |
|
| prepay_id |
是 |
string |
生成订单后获取预支付id |
|
| timeStamp |
是 |
string |
时间戳 |
|
| sign |
是 |
string |
微信返回签名 |
返回参数
{
"code": "000000",
"msg": "请求成功",
"data": {
"trade_type":"JSAPI",
"mch_id":"1609222413",
"sub_mch_id":"1616950579",
"appid":"wxa9c11930de1ce706",
"nonce_str":"iixmb071Of8gH5wz",
"device_info":"WEB",
"out_trade_no":"202111301100401383",
"total_fee":"1",
"sign":"0D1800FD3CE0101F9529B145E136D42D",
"result_code":"SUCCESS",
"return_code":"SUCCESS",
"return_msg":"OK",
"prepay_id":"wx30110041193633678cf1a7cb3989cf0000",
"timeStamp":"1638241241"
},
"status": 200
}
4.微信订单查询接口
请求路径
*POST /v1/iot/parkinglot/iot-payment/wechat/pay/resultQuery
请求参数
| 字段 |
是否必须 |
字段类型 |
描述 |
备注 |
| openid |
是 |
string |
调用微信公众号授权后openid |
|
| out_trade_no |
是 |
string |
平台订单号 |
部分响应参数说明
返回参数
{
"code": "000000",
"msg": "请求成功",
"data": {},
"status": 200
}