Prepare eSIM Installation

Check for eSIM capable device

First, you need to check if the device is eSIM capable.

This query may take some time (up to multiple seconds on some devices) to complete. Make sure you wait for the completion before triggering an eSIM installation.

Gigastore.isEsimCapable(completion: { (isCapable) in    
    print("\(isCapable)")}
)

If a "false" is returned from the query despite the following criteria being met:

• Your device is eSIM capable

• You have added the run script for your Info.plist and your entitlements file.

Then there is likely another problem.

If this problem persists, please contact [e-mail].

The isEsimCapable method can be used to check whether the user's device is eSIM capable or not.

Activate Inventory Item using API

Implementation changed with SDK version 1.1.

To install an eSIM, an inventory item must first be activated using the Gigastore API on your server. For more information, refer to the First PackageAPI documentation.

Use the esimProfile.uid parameter of the API response and transfer it securely to your app.

Retrieve the profile

Use the getProfile method with the created profile uid to fetch all needed profile data. The method will return a profile you can install in the next step using Install Profile.

let profileUID = "123456-abcde-abcde-789" // from API
Gigastore.getProfile(profileUID: self.profileUidValue, 
                     completion: { (profile, error) -> Void in
                         
   print("PreparedProfile: \(profile), error: \(error)")
})