静态-下单
为子用户购买指定地区、天数与数量的静态 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"
}
}