How to install the Airalo Shopify App - Airalo Developer Platform

Follow these steps to configure the Airalo Shopify App:

Install the app

Search for the Airalo app in the Shopify App store and click Install. You can find a direct link to the app here.

Get your API credentials in the Airalo Partner Platform

Navigate to the Partner Platform.

Select the API Integration menu. (Note that it is only available for dedicated users.)

Copy the API Client ID and API Client Secret.

Enter the API credentials in the Airalo Shopify App settings

Use the credentials provided by the Airalo Partner API to authenticate the plugin.

If you encounter issues with your API credentials, ensure they are copied correctly. Log in to the Partner Platform, navigate to the API Integration menu, and copy-paste the client_id and client_secret into the app settings under the production credentials.

Configure your synchronization settings

Language: Choose the preferred language for product descriptions. Note that the sandbox environment only supports a few languages, while the production environment supports 53 languages.

Sync images: Enable this option if you want to use the Airalo images assigned to eSIM packages.

Auto sync: Enable this if you want new eSIM packages to be published automatically. If not, they will sync as “Draft” for manual review.

Update product title / Update product description
If these options are checked, the Airalo app will automatically update the product title and description. If unchecked, the title and description will only be set when the product is first created and won’t be updated later. This is useful if you want to write your own product titles and descriptions.

Configure the webhook token

Configuring the webhook token is necessary to ensure secure communication between Shopify and Airalo.

Open Settings by clicking the bottom left corner.

From the side menu, select Notifications.

Choose the Webhooks option.

Copy the entire string displayed under "Your webhooks will be signed with." Ensure you copy the full value.

Go back to the Airalo app configuration page.

Paste the webhook token into the Webhook Token field.

Save your settings

After configuring all the necessary options, click Save Settings to apply the settings.

Sync products and orders

The Airalo Shopify App will now automatically sync eSIM packages every hour.

You can initiate the synchronization by clicking the Synchronize Packages button.

Please follow these steps to set up the required webhook for your store:

Open Settings by clicking the bottom left corner.

From the side menu, select Notifications.

Choose the Webhooks option.

Click Create webhook (top right of the Webhooks section).

In the Event dropdown, select Order creation.

In the Format dropdown, select JSON.

In the URL field, enter the following endpoint:
https://airalo-shpf.partners.airalo.com/api/v1/order

Click Save.

That’s it! Your webhook is now set up and will notify our system every time a new order is created.

Configure retail prices manually or via export/import

Configure payment gateway

Ensure your payment gateway is set up in Shopify.