Online Renewal

Applicable Scenarios

To extend the service validity period of a SIM card's data plan, either before or after its expiration, for SIM cards obtained through a new online purchase order.

Prerequisites

Operations are only supported for SIM cards belonging to the enterprise associated with the API key in use.

The SIM card's service contract must be within its validity period and not in the 'Deactivated' state.

The SIM card must have been obtained through a new purchase via Online Order.

Notes

Renewal operations are processed asynchronously. A successful synchronous API response indicates that the Linke system has successfully received the request.

Methods to get the asynchronous processing result:

Query Renewal Order using the renewal order number.

Receive the result via a notification API callback with the status pending.

The asynchronous processing time varies depending on the number of SIM cards and network congestion in the carrier's system. It can take several tens of minutes or even longer.

For SIM cards submitted in the same renewal order, some may be processed successfully while others may fail. Information for failed SIM cards will not be returned upon query.

Idempotency check: Orders placed with the same parameters within 10 seconds are treated as the same request. The original order number will be returned directly, and no new order will be created.

Business Rules

For SIM cards in the 'Suspended (for non-payment)' state, the status will change to 'In Use' after a successful renewal.

For SIM cards in the 'Silent' or 'Suspended' state, their status will remain unchanged after a successful renewal.

SDK API Call Method

SDK versions supported: 1.0.8 and above

Request

Header Params

Body Params application/json

Example

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Applicable Scenarios#

Prerequisites#

Notes#

Business Rules#

SDK API Call Method#