Skip to content

动态-给子用户下单并余额支付 ​

为子用户购买流量套餐;每次下单须携带唯一 orderToken 以防重复订单。

鉴权

所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取,并可根据需要重置。详见 通用信息。

接口描述 ​

项目说明
方法POST
地址https://api2.ipmart.io/custom/pay

输入参数 ​

参数名称必选类型描述
id是String子用户唯一标识
capacity是Int购买容量(GB,须与产品规格一致)
orderToken是String随机码;同一订单重复请求应使用相同 token,不同订单须使用不同 token

重要输出参数 ​

参数名称必选类型描述
status是IntHTTP 层返回码
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
}