A partner ecosystem created to grow business

1. Background: Composable Commerce at 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 via API interfaces.

Benefits for partners:

• Flexibility: You can introduce new features and integrations without extensive changes to the core code.

• Scalability: A comprehensive microservice model allows for customized solutions (e.g., payment, ERP, and search integrations).

• Rapid product development: Publish your own extensions independently, while the AI Commerce team ensures security and infrastructure behind the scenes.

2. GraphQL: Efficient Data Retrieval Layer

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

Why GraphQL?

1. Customized queries: Partners can define precisely what data is returned, thereby avoiding unnecessary data transfer.

2. Fewer requests: Complex database queries can be combined into a single GraphQL request instead of multiple calls to a REST interface.

3. Unified interface: All data can be accessed through a single endpoint.

Example of a GraphQL query (POST)

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 others:

• X-GraphQL-Secret: The AI Commerce security key

• X-Tenant-Id: Store alias (e.g., "boeing")

• X-Tenant-Secret: The tenant's own API key

We recommend always using the AI Commerce internal load balancer address, APP_LOAD_BALANCER_URL, so that the request remains fast and securely 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, it returns 429 Too Many Requests.

3. Serverless Lambda Environment: Partner Extensions Safely

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

What does this mean?

1. Fast and secure connection

   • You don’t need to transfer data over the public network; all traffic remains within AI Commerce's internal VPC.

2. Choose your programming language

   • Lambda broadly supports different runtimes (Java, Node.js, Python, .NET, Go, Rust, etc.).

3. Easy deployment process

   • You will receive your own AWS CLI keys, allowing you to publish your code.

   • A shared domain under CloudFront and API Gateway manages the routing, so everything appears as a unified part of AI Commerce externally.

4. GitHub repository

   • Each partner (or customer) has their own “extensions-” repository, where the code is pushed and deployed using the serverless framework.

4. Who are serverless extensions suitable for?

• ERP integrations: You can synchronize AI Commerce 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's native search services.

• New features: Comprehensive extensions for order processing, logistics, payments, or other business processes.

5. Development process in brief

1. Clone the repo

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

1. Install the tools

AWS CLI, Node.js, Serverless Framework, and your choice of language build tools (e.g., Maven, pip, dotnet-cli).

2. Edit serverless.yml

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

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

3. Deploy

serverless deploy

Create Lambda functions, API Gateway routes, and other resources in the AWS environment managed by AI Commerce.

4. Test

You will receive a URL as a response via which the service is available. Call it using cURL or a browser:

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

6. Extensions and “overrides”

• Extensions: A partner adds a new microservice that handles, for example, orders or calls third-party systems.

• Override: Certain native routes of AI Commerce can be bypassed (e.g., search function) by directing the frontend directly to your developed Lambda. This creates ultimate flexibility in the Composable Commerce model.

7. Summary

The modern architecture of AI Commerce combines GraphQL interface, serverless Lambda environment, and 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 scoped way to query data.

• Comprehensive environment: API Gateway, CloudFront, and Lambda are pre-configured, allowing you to focus on business logic.

• Security and performance: Everything stays within AI Commerce's internal network, minimizing latencies and enhancing data security.

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

Check out our partners here!