Skip to content

静态-下单 ​

为子用户购买指定地区、天数与数量的静态 IP。

鉴权

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

接口描述 ​

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

输入参数 ​

参数名称必选类型描述
subUserId是String子用户 ID
areaCode是String区域编码
countryCode是String国家编码
cityCode是String城市编码
days是Int购买天数
num是Int购买数量
totalPrice是String订单总价(渠道商专属单价×数量,不含数量折扣;最多保留 2 位小数且向下取整)

重要输出参数 ​

参数名称必选类型描述
status是Int返回码
errorMsg否String失败时的错误信息
data是Object订单信息,字段见下
id是String订单 ID(位于 data.id)
no是String订单号
paid是Boolean是否已支付
data.status是String订单状态,1 = 已支付待发货
order_time是String下单时间(毫秒时间戳)
pay_time是String支付时间(毫秒时间戳)

发送示例 ​

json
{
  "subUserId": "661f908102ca4953bc555a18",
  "areaCode": "NA",
  "countryCode": "US",
  "cityCode": "Random",
  "days": 30,
  "num": 1,
  "totalPrice": "3.5"
}

返回示例 ​

成功 ​

json
{
  "status": 200,
  "errorMsg": null,
  "data": {
    "id": "66d95fd43e28885e230f3137",
    "no": "20260927170000000",
    "paid": true,
    "status": "1",
    "order_time": "1727424000000",
    "pay_time": "1727424000123"
  }
}