A partner ecosystem created to grow business

The AI Commerce Cloud partner ecosystem is designed to help grow customer businesses by combining Composable Commerce principles, a GraphQL API, and a fully serverless environment. We offer partners a simple, secure, and high-performance way to extend AI Commerce Cloud using the programming language of their choice.

Home

Blog

A partner ecosystem created to grow business

Lauri Koskensalo

Head of Growth

min read

20.3.2025

1. Background: Composable Commerce in AI Commerce

Composable Commerce philosophy means that each component (product management, order processing, customer management, etc.) is implemented as its own microservice. Instead of a unified platform, these services communicate through API interfaces.

Benefits for partners:

Flexibility: You can bring new features and integrations without extensive changes to the core code.
Expandability: A comprehensive microservice model opens up the possibility of implementing customized solutions (e.g., payment, ERP, and search integrations).
Rapid product development: Publish your own extensions independently, with the AI Commerce team taking care of security and infrastructure in the background.

2. GraphQL: An efficient data query language

AI Commerce offers a GraphQL interface (Apollo), through which partners can retrieve the data they need – for example, products, prices, or countries.

Why GraphQL?

Customized queries: The partner can specify exactly what data is returned, avoiding unnecessary data transfer.
Fewer requests: Complex database queries can be combined into a single GraphQL request instead of multiple calls to a REST interface.
Unified interface: All data can be retrieved through the same endpoint.

Example of a GraphQL query (POST)

{
  "query": "{
    products(limit: 5, offset: 0) {
      id
      name
      price
    }
  }"
}

Request response (JSON)

{
  "data": {
    "products": [
      { "id": "632", "name": "721H",       "price": 89.9 },
      { "id": "637", "name": "TC7092",     "price": 49.9 },
      { "id": "697", "name": "JERONE50EUR","price": 50   },
      { "id": "698", "name": "JERONE100EU","price": 100  },
      { "id": "699", "name": "JERONE200EU","price": 200  }
    ]
  }
}

Secured headers

Every GraphQL request requires, among other things:

X-GraphQL-Secret: AI Commerce's security key
X-Tenant-Id: Store alias (e.g. “boeing”)
X-Tenant-Secret: Tenant’s own API key

We recommend always using AI Commerce's internal load balancer address, APP_LOAD_BALANCER_URL, to ensure the request remains fast and secure within AI Commerce's VPC.

Rate Limiting

Our system limits the number of requests (e.g. 100 requests / 5 min per tenant). In case of exceeding limits, a 429 Too Many Requests response will be returned.

AI Commerce offers a GraphQL interface (Apollo), through which partners can retrieve the data they need – for example, products, prices, or countries.

Why GraphQL?

Customized queries: The partner can specify exactly what data is returned, avoiding unnecessary data transfer.
Fewer requests: Complex database queries can be combined into a single GraphQL request instead of multiple calls to a REST interface.
Unified interface: All data can be retrieved through the same endpoint.

Example of a GraphQL query (POST)

{
  "query": "{
    products(limit: 5, offset: 0) {
      id
      name
      price
    }
  }"
}

Request response (JSON)

{
  "data": {
    "products": [
      { "id": "632", "name": "721H",       "price": 89.9 },
      { "id": "637", "name": "TC7092",     "price": 49.9 },
      { "id": "697", "name": "JERONE50EUR","price": 50   },
      { "id": "698", "name": "JERONE100EU","price": 100  },
      { "id": "699", "name": "JERONE200EU","price": 200  }
    ]
  }
}

Secured headers

Every GraphQL request requires, among other things:

X-GraphQL-Secret: AI Commerce's security key
X-Tenant-Id: Store alias (e.g. “boeing”)
X-Tenant-Secret: Tenant’s own API key

We recommend always using AI Commerce's internal load balancer address, APP_LOAD_BALANCER_URL, to ensure the request remains fast and secure within AI Commerce's VPC.

Rate Limiting

Our system limits the number of requests (e.g. 100 requests / 5 min per tenant). In case of exceeding limits, a 429 Too Many Requests response will be returned.

AI Commerce offers a GraphQL interface (Apollo), through which partners can retrieve the data they need – for example, products, prices, or countries.

Why GraphQL?

Customized queries: The partner can specify exactly what data is returned, avoiding unnecessary data transfer.
Fewer requests: Complex database queries can be combined into a single GraphQL request instead of multiple calls to a REST interface.
Unified interface: All data can be retrieved through the same endpoint.

Example of a GraphQL query (POST)

{
  "query": "{
    products(limit: 5, offset: 0) {
      id
      name
      price
    }
  }"
}

Request response (JSON)

{
  "data": {
    "products": [
      { "id": "632", "name": "721H",       "price": 89.9 },
      { "id": "637", "name": "TC7092",     "price": 49.9 },
      { "id": "697", "name": "JERONE50EUR","price": 50   },
      { "id": "698", "name": "JERONE100EU","price": 100  },
      { "id": "699", "name": "JERONE200EU","price": 200  }
    ]
  }
}

Secured headers

Every GraphQL request requires, among other things:

X-GraphQL-Secret: AI Commerce's security key
X-Tenant-Id: Store alias (e.g. “boeing”)
X-Tenant-Secret: Tenant’s own API key

We recommend always using AI Commerce's internal load balancer address, APP_LOAD_BALANCER_URL, to ensure the request remains fast and secure within AI Commerce's VPC.

Rate Limiting

Our system limits the number of requests (e.g. 100 requests / 5 min per tenant). In case of exceeding limits, a 429 Too Many Requests response will be returned.

3. Serverless Lambda environment: Partner extensions safely

AI Commerce Cloud has introduced a serverless environment, where you can run your own microservices (Lambda functions) within the same VPC as AI Commerce Cloud's core services. This allows you to build new logic or expand existing functionalities without touching the core code itself.

What does this mean?

Fast and secure connection
- No need to transfer data over the public network; all traffic remains within AI Commerce's internal VPC.
Choose your preferred programming language
- Lambda supports a wide range of runtimes (Java, Node.js, Python, .NET, Go, Rust, etc.).
Easy deployment process
- You will obtain your own AWS CLI keys, which you can use to publish your code.
- A shared domain under CloudFront and API Gateway manages the routing, so outwardly everything appears as a single entity of AI Commerce.
GitHub repository
- Each partner (or customer) has their own "extensions-" repository, where the code is pushed and deployed using the serverless framework.

4. Who is serverless integration suitable for?

ERP Integrations: You can synchronize AI Commerce Cloud orders or product inventories directly with the customer's ERP system (SAP, Microsoft Dynamics, NetSuite, etc.).
Search Functions: If you have your own search solution (e.g. Elasticsearch, Solr), you can extend or replace AI Commerce Cloud's native search services.
New Features: Comprehensive extensions for order processing, logistics, payments, or other business processes.

5. Development process briefly

Clone the repo

git clone https://github.com/petrosoft-fi/extensions-clientName.git
cd extensions-clientName

Install the tools

Install AWS CLI, Node.js, the Serverless Framework, and the build tools for your chosen language (e.g., Maven, pip, dotnet-cli).

Edit serverless.yml

Set the runtime (such as java21, nodejs22.x, or python3.13).

Reference the compiled package (e.g., target/my-project.jar for a Java project).

serverless deploy

Deploy

Deploy your Lambda function, API Gateway routes, and other resources into the AWS environment managed by AI Commerce Cloud.

Test

You’ll receive a URL where the service is available. Test it using cURL or your browser:

curl https://example.com/ext/your-endpoint

Clone the repo

git clone https://github.com/petrosoft-fi/extensions-clientName.git
cd extensions-clientName

Install the tools

Install AWS CLI, Node.js, the Serverless Framework, and the build tools for your chosen language (e.g., Maven, pip, dotnet-cli).

Edit serverless.yml

Set the runtime (such as java21, nodejs22.x, or python3.13).

Reference the compiled package (e.g., target/my-project.jar for a Java project).

serverless deploy

Deploy

Deploy your Lambda function, API Gateway routes, and other resources into the AWS environment managed by AI Commerce Cloud.

Test

You’ll receive a URL where the service is available. Test it using cURL or your browser:

curl https://example.com/ext/your-endpoint

Clone the repo

git clone https://github.com/petrosoft-fi/extensions-clientName.git
cd extensions-clientName

Install the tools

Install AWS CLI, Node.js, the Serverless Framework, and the build tools for your chosen language (e.g., Maven, pip, dotnet-cli).

Edit serverless.yml

Set the runtime (such as java21, nodejs22.x, or python3.13).

Reference the compiled package (e.g., target/my-project.jar for a Java project).

serverless deploy

Deploy

Deploy your Lambda function, API Gateway routes, and other resources into the AWS environment managed by AI Commerce Cloud.

Test

You’ll receive a URL where the service is available. Test it using cURL or your browser:

curl https://example.com/ext/your-endpoint

6. Extensions and 'overwriting'

Extensions: The partner adds a new microservice that handles, for example, orders or calls third-party systems.
Overriding: Certain native routes of AI Commerce Cloud can be bypassed (e.g., search function) by directing the frontend straight to your developed Lambda. This creates ultimate flexibility in the Composable Commerce model.

7. Summary

The modern architecture of AI Commerce brings together a GraphQL API, a serverless Lambda environment, and a flexible Composable Commerce philosophy. Partners can securely and scalably implement their own solutions on a "silver platter":

Full control: You can develop and publish code independently.
Efficient data retrieval: GraphQL provides a fast and precisely defined way to fetch data.
Comprehensive environment: API Gateway, CloudFront, and Lambda are pre-configured, allowing you to focus on business logic.
Security and performance: Everything stays within the AI Commerce private network, minimizing latency and enhancing data security.

We want to make collaboration easy and smooth. If you need more information, our support team is ready to help. Welcome to expand AI Commerce with your own solutions – the modern serverless world awaits!

Check out our partners here!

Full control: You can develop and publish code independently.
Efficient data retrieval: GraphQL provides a fast and precisely defined way to fetch data.
Comprehensive environment: API Gateway, CloudFront, and Lambda are pre-configured, allowing you to focus on business logic.
Security and performance: Everything stays within the AI Commerce private network, minimizing latency and enhancing data security.

Check out our partners here!

A partner ecosystem created to grow business

2. GraphQL: An efficient data query language

3. Serverless Lambda environment: Partner extensions safely

4. Who is serverless integration suitable for?

5. Development process briefly

6. Extensions and 'overwriting'

7. Summary

Lauri Koskensalo

Head of Growth

Lauri is an eCommerce technology expert and Head of Growth at AI Commerce Cloud. He helps businesses grow through modern solutions and is always happy to talk about developing and optimizing online stores.

info@aicommerce.fi

Contact

12.1.2026

Aleksi Hautamäki – Customer Success Manager

Aleksi joined AI Commerce Cloud in early 2026 in a new role as Customer Success Manager, strengthening our customer-facing expertise and supporting long-term customer success.

18.12.2025

Guest article: Why PIM is critical to competitiveness in omnichannel e-commerce

Product information has become a decisive competitive factor in e-commerce. This guest article explains why Product Information Management (PIM) is no longer optional in omnichannel commerce, how different PIM approaches compare, and what businesses should consider when selecting a solution that supports growth, efficiency, and conversion.

6.12.2025

Organization Management for B2B Customers

Learn how AI Commerce Cloud enables secure, role-based purchasing for business accounts. Manage users, permissions, and orders at the organization level with reduced admin workload.