> For the complete documentation index, see [llms.txt](https://docs.giga.store/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giga.store/ios/ios-universal-link.md).

# 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](https://developer.apple.com/ios/universal-links/) 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

<br>