For the complete documentation index, see llms.txt. This page is also available as Markdown.

iOS Universal Link

With iOS 17.4 and above, Apple has introduced the ability for users to install their eSIM directly onto their devices by clicking a simple link. The Universal Link installation method works by appending the unique SMDP+ address and Activation Code as parameters to the universal link URL, which can be tied to a button in your application. The universal link would look as follows:

URL
Activation code
Universal Link Sample

https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=

LPA:1$SMDP+_Address$Activation_Code

https://esimsetup.android.com/esim_qrcode_provisioning?carddata=LPA:1$SMDP+_Address$Activation_Code

https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=

LPA:1$rsp.truphone.com$JQ-209U6H-6I82J5

https://esimsetup.android.com/esim_qrcode_provisioning?carddata=LPA:1$rsp.truphone.com$JQ-209U6H-6I82J5

Important Notes for Implementation:

  1. URL Casing: The base URL should always be in lowercase to ensure compatibility and avoid errors in processing.

  2. Activation Code: The Activation Code may contain capital letters and should be entered strictly as provided.

  3. External Link Configuration: If integrating this link within an app, configure it to open externally. This ensures that the device’s browser handles the activation, adhering to Apple’s setup protocols.

SMDP+ address and Activation Code are provided with this request

POST /gigastore/activations/register

Last updated

Was this helpful?