Understanding the SIM lifecycle

SIMs in normal operation go through a lifecycle. As they transition between states, the charges can vary. The states in Infinity use different terminology to those exposed in the APIs:

Before a customer can use a SIM, they must purchase the SIM hardware and sign a service contract, agreeing to the associated costs.

When all agreed payments are made, the SIM belongs to the customer. Eseye prepares the SIMs for shipping, which includes linking each SIM to a customer account and assigning a package to each SIM. The security and identity information for each bootstrap profile IMSI (on a multi-IMSI SIM) is preconfigured on the SIM during factory manufacture.

Any associated charges start when the SIM becomes Active (also known as provisioned).

Depending on the platform you are working with, you may see any of the following Infinity states or API statuses:

Infinity State	Tigrillo API Status	Description
available	available	The SIM or IMSI (for multi-IMSI SIMs) exists on a customer account and is assigned a package. No charges are incurred. The customer must request to activate the SIM for use. The SIM cannot connect to a network in this state.
pendingProvision	pendingProvision	The SIM or IMSI (for multi-IMSI SIMs) undergoes provisioning, which may take a while to complete. During this process on an Operational (Step 2) Profile (for eUICC SIMs), the security and identity information is downloaded and programmed into the SIM. Customers can process up to 5000 SIM activations at one time using Infinity Classic. There are no limitations within the API.
active	provisioned	The SIM or IMSI (for multi-IMSI SIMs) is ready for use – it is fully authenticated by the HLR and active on the network. The SIM or IMSI is charged at standard service charge rates, and for any usage. For AnyNet SIM API, if you deactivate an active SIM, it returns to an available state.
suspended	suspended	Both Eseye and the customer can temporarily disable SIM functionality using either Eseye or customer-configured rules. At this point, the SIM is able to connect to a network, although all services are disabled. While this process closes all data sessions, standard rate service charges continue. You cannot suspend an IMSI. Eseye suspends SIMs for non-payment, or to protect against security alerts or potential abuse issues. When Eseye suspends a SIM, the customer cannot reactivate it. Customers may suspend their SIM for the following reasons: To prevent unauthorised usage if the device is lost or stolen They want to move the SIM to a different device, but not immediately They are not using the device for a significant period of time, but want to maintain the current contract for that device Customers can reactivate their suspended SIMs.
pendingTermination	pendingDeprovision	Eseye or the customer have requested termination (also known as deprovisioning), which will prevent the SIM or IMSI (on a multi-IMSI SIM) accessing network services and incurring subsequent usage charges. Termination is processed by Support, and is not instant. If the SIM is in contract, the customer is liable for the rest of the service charges up until the end date of the contract. If charges are owed, the customer is sent a separate termination invoice. For multi-IMSI SIMs, you can terminate an individual IMSI without terminating all the IMSIs on the SIM. For example, if the multi-IMSI SIM has O2, Manx and MTN IMSIs, you can terminate O2 but maintain active Manx and MTN IMSIs. Customers can process up to 5000 SIM terminations at one time using Infinity Classic. There are no limitations within the API. We request that before you terminate more than 5000 SIMs, you provide at least 24 hours' notice to Support so that we can help you manage the process. Eseye may terminate a SIM for the following reasons: If the SIM is unused for a long period of time If the SIM is used outside of the terms of the service contract The SIM is broken If the customer account is in arrears Customers may terminate their SIM for the following reasons: They are leaving Eseye The SIM or device is written off as lost or stolen The device is obsolete or destroyed Their customer no longer wants service Their customer stopped paying the bill For more information, see Standard Terms and Conditions (downloads a PDF).
terminated	unprovisioned	The SIM or IMSI (for multi-IMSI SIMs) is deprovisioned. The SIM stops connecting to the network and nobody can use the SIM. Service charges stop. The physical SIM and its associated numbers remain the property of the customer for an extended period. After this, the number will revert to the pool of numbers that belongs to Eseye and the physical SIM will need replacing if the customer wants to reuse the device. For multi-IMSI SIMs, when all IMSIs that exist on the SIM are deprovisioned, then the SIM is terminated. It is possible to terminate (deprovision) an IMSI but have other active (provisioned) IMSIs on the same SIM. In this case, the SIM is not terminated.