This guide will show you how to connect your Salla store to API2Cart in just a few steps.

Step 1: Create an App

First, you need to register in the Salla Partner Center as a developer.

After registering, go to the My Apps page and create a new application.

How to connect Salla to API2Cart

Then, select Public App if you plan to publish your app on the Salla App Store. Alternatively, choose Private App if you want to install the app only on specific stores using a private link.

Next, fill in the basic information about the application.

How to connect Salla to API2Cart

In the APP Keys section, you need to choose a method for obtaining credentials (OAuth Mode).

How to connect Salla to API2Cart
If you select Easy Mode, the Access Token and Refresh Token (required to add a store to API2Cart) will be obtained automatically via a webhook as soon as the client installs the app. In contrast, in Custom Mode, you will need to implement the process of obtaining the Access Token and Refresh Token yourself. You can find more details here.

In this guide, we will cover Easy Mode only.

For Easy Mode, you need to specify the Webhook URL that will receive webhooks containing the store credentials.

How to connect Salla to API2Cart

In the App Scope section, you need to configure the app's access permissions.

How to connect Salla to API2Cart
To avoid any potential issues with API functionality in the future, we strongly recommend selecting all scopes.

Step 2: Installing the Application

To install the application in the store, you need to prepare the installation URL. Specifically, the installation URL has the following format:

      https://s.salla.sa/apps/install/{app-id}
    

Here, the app_id can be obtained from the application settings.

How to connect Salla to API2Cart

Then, the shop owner needs to visit this link in a browser where they've already logged into the store and confirm the app's installation.

How to connect Salla to API2Cart

Once installed, the app allows you to connect Salla to API2Cart by retrieving the necessary access credentials.

After the store owner confirms the app installation, you will receive a webhook containing the necessary credentials.

How to connect Salla to API2Cart

Step 3: Connect via API2Cart

After obtaining the Refresh Token, you can proceed to connect Salla to API2Cart.

How to connect Salla to API2Cart

The salla_client_id and salla_client_secret parameters can be found in the application's dashboard under the App Keys section.

Moreover, the salla_refresh_token parameter was obtained in Step 2 of this guide.

If you have any questions during the app creation process or notice any differences between the elements shown in this guide's screenshots and the actual interface, please refer to the official documentation of the platform.