动态-给子用户下单并余额支付
为子用户购买流量套餐;每次下单须携带唯一 orderToken 以防重复订单。
鉴权
所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取,并可根据需要重置。详见 通用信息。
接口描述
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 地址 | https://api2.ipmart.io/custom/pay |
输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | String | 子用户唯一标识 |
| capacity | 是 | Int | 购买容量(GB,须与产品规格一致) |
| orderToken | 是 | String | 随机码;同一订单重复请求应使用相同 token,不同订单须使用不同 token |
重要输出参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| status | 是 | Int | HTTP 层返回码 |
| errorMsg | 否 | String | 错误信息 |
| id | 是 | String | 订单唯一标识(位于 data.id) |
| no | 是 | String | 订单编号(位于 data.no) |
| capacity | 是 | Int | 产品容量(位于 data.capacity) |
| paid | 是 | Boolean | 是否已支付(位于 data.paid) |
| data.status | 是 | String | 订单状态:0 待付款。已下单但尚未完成付款1 待发货。已付款,等待分配流量2 已完成。已分配流量,订单完成3 主动取消。订单被买家取消4 被动取消。订单被管理员取消5 过期失效。订单超时自动取消6 支付中。支付结果未知 |
| order_time | 是 | String | 下单时间(位于 data.order_time) |
| pay_time | 是 | String | 支付时间(位于 data.pay_time) |
| orderToken | 是 | String | 回传随机码,用于确认订单是否创建成功 |
发送示例
json
{
"id": "66d56bd0c802a6315affa403",
"capacity": 1,
"orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}返回示例
成功
json
{
"status": 200,
"errorMsg": null,
"data": {
"no": "20240905153756202",
"paid": true,
"id": "66d95fd43e28885e230f3137",
"order_time": "2024-09-05 15:37:56",
"capacity": 1,
"status": "1",
"pay_time": "2024-09-05 15:37:56",
"orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}失败
json
{
"status": 400,
"errorMsg": "订单无效,无法确认付款",
"data": null
}