Reset to Initial Settings (Asynchronous)

Brief Description

Version:

v4

Use Case

After a SIM card is delivered to an end user with a device, if after-sales issues such as returns occur, you need to restore the SIM card's bound plan, status, and other data to the initial state it was in when Linkage delivered it to the customer.
Using this feature will incur additional charges. For details, please consult Linkage business personnel.

Prerequisites

The enterprise that owns the API key must be the same as the enterprise that owns the SIM card.

The SIM card does not support OTA functionality.

The SIM card status cannot be Silent, Deactivated (or Suspended if the number retention period has expired).

Notes

The operation is processed asynchronously. A successful synchronous API response indicates that the Linkage system has successfully received the request.

Methods for obtaining the asynchronous processing result:

Use the request_id from the API response header to query the result via Query Asynchronous Processing Result.

Obtain the result via a notification API callback (pending).

Before the asynchronous processing is complete, the card will be in a locked state. During this time, other operations on the same SIM, such as activation, suspension, reactivation, or reset, are prohibited.

The asynchronous process usually completes within a few seconds. However, if anomalies such as network congestion occur in the carrier's system, the processing time may extend to tens of minutes or even longer.

If the asynchronous operation fails, the user can initiate it again.

SDK API Call Method

Minimum supported SDK version: 1.0.11

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Brief Description#

Version:#

Use Case#

Prerequisites#

Notes#

SDK API Call Method#

Request