在线续费

适用场景

对于通过在线下单新购获取的SIM卡在流量服务到期前或到期后，申请延长SIM卡套餐服务有效期。

必要条件

仅支持对所用API key归属企业下的SIM进行操作。

SIM卡服务合约在有效期内，且不能为废弃期。

SIM卡的获取途径为通过在线下单下新购单获取。

注意事项

续费操作的处理为异步，接口同步响应成功代表领科系统接收请求成功。

获取操作异步处理结果的方式：

通过续费单号查询续费订单

通过notification api回调获取结果 pending

异步处理时间根据SIM卡数量，运营商系统的网络拥塞情况存在差异，处理时长可达几十分甚至更长。

对同一个续费单提交的SIM卡，有可能处理成功或失败,对于处理失败的SIM卡查询时将不返回信息。

幂等校验：对10秒内采用相同参数下单，视为同一请求，直接返回原订单号，不做新增处理。

业务规则

对于停机保状态的SIM片，续费处理成功后，SIM卡状态将变更为使用期。

对于静默期、暂停期状态的SIM片，续费处理成功后，SIM卡状态不变。

SDK API 调用方式

SDK支持版本：1.0.8及以上

请求参数

Header 参数

Body 参数application/json

示例

{
    "items": [
        {
            "id": "CP-6HPXRQI88QSM",
            "quantity": 2,
            "sim_ids": [
                "89248044404413065327"
            ]
        }
    ],
    "extra": {
        "po": "1235215555",
        "remarks": "续费本地测试"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "data": {
        "status": 1,
        "created_at": 1686707689000,
        "order_id": "OL-6XB9I9XX8QNR"
    },
    "status": {
        "code": "CB-00-0000",
        "message": "成功",
        "detail": "https://developer.linksfield.net/doc-1413557?nav=01GBM770ARR76AXBD5856Z6J6P"
    }
}

🟢200success

适用场景#

必要条件#

注意事项#

业务规则#

SDK API 调用方式#