Commerce Services Connector

Some Adobe Commerce and Magento Open Source features are powered by Commerce Services and deployed as SaaS (software as a service). To use these services, you must connect your Commerce instance using production and sandbox API keys, and specify the data space in the configuration. You only need to set this up once.

Available services

The following lists the Commerce features you can access through the Commerce Services Connector:

Architecture

At a high level, the Commerce Services Connector is made up of the following core elements:

The following sections discuss each of these elements in more detail.

Credentials

The production and sandbox API keys are generated from the Commerce account of the license holder, which is identified by a unique Commerce ID (MageID). To pass entitlement validation for services such as Product Recommendations or Live Search, the license holder of the merchant’s organization can generate the set of API keys as long as the account is in good standing. The keys can be shared on a “need to know” basis with the systems integrator or development team that manages projects and environments on behalf of the license holder. Additionally, solution integrators are also entitled to use Commerce Services. If you are a solution integrator, the signer of the Commerce partner contract should generate the API keys.

Generate the production and sandbox API keys

1. Log in to your Commerce account at https://account.magento.com.

2. Under the Magento tab, select API Portal on the sidebar.

3. From the Environment menu, select Production or Sandbox.

4. Enter a name in the API Keys section and click Add New.

   This opens a dialog for downloading the new key.

   

   WARNING

   This is the only opportunity that you have to copy or download your keys.

5. Click Download then click Cancel.

6. Repeat the above steps for each environment (production and sandbox).

   The API Keys section now displays your API keys. You need both the production and sandbox keys when you select or create a SaaS project.

SaaS configuration

Commerce instances must be configured with a SaaS Project and a SaaS Data Space so that Commerce Services can send data to the right location. A SaaS Project groups all SaaS Data Spaces. The SaaS Data Spaces are used to collect and store data that enables Commerce Services to work. Some of this data may be exported from the Commerce instance and some may be collected from shopper behavior on the storefront. That data is then persisted to secure cloud storage.

For Product Recommendations, the SaaS data space contains catalog and behavioral data. You can point a Commerce instance to a SaaS data space by selecting it in the Commerce configuration.

Select or create a SaaS project

To select or create a SaaS project, request the Commerce API key from the Commerce license holder for your store.

1. On the Admin sidebar, go to System > Services > Commerce Services Connector.

2. In the Sandbox API Keys and Production API Keys sections, paste your key values.

   Private keys must include ----BEGIN PRIVATE KEY--- at the beginning of the key and ----END PRIVATE KEY---- at the end of the private key.

3. Click Save.

Any SaaS projects that are associated with your keys appear in the Project field in the SaaS Identifier section.

1. If no SaaS projects exist, click Create Project. Then in the Project field, enter a name for your SaaS project.

   When you create a SaaS project, Commerce generates one or more SaaS data spaces depending on your Commerce license:

   • Adobe Commerce - One production data space; two testing data spaces
   • Magento Open Source - One production data space; no testing data spaces

2. Select the Data Space to use for the current configuration of your Commerce store.

To change the SaaS project or data space names, click Rename.

IMS Organization (optional)

To connect your Adobe Commerce instance to the Adobe Experience Platform, sign in to your Adobe account using your Adobe ID. After you sign in, the IMS organization associated with your Adobe account is displayed in this section.

Catalog sync

When your Commerce instance successfully connects to Commerce Services, the catalog sync process exports product data from your Commerce server to Commerce Services. Currently, only Product Recommendations uses the catalog sync service. Learn more about the catalog sync process.