This document outlines the process of developing and deploying applications on the Infosys Equinox Commerce platform, followed by their integration into the App Marketplace.

Overview

App development in the Infosys Equinox Commerce platform via the App Marketplace involves creating applications that extend the platform’s capabilities for merchants and storefronts.

App development on the Infosys Equinox platform follows a two-phase process:

Create and Deploy the App (Phase 1)

This phase involves writing the application code, implementing business logic, and deploying the app in a cloud or serverless environment. The app must be capable of handling webhook payloads, verifying signatures, and securely communicating with both the Infosys Equinox Commerce platform and third-party services.

1. Set Up for Serverless App

  • Node.js 18.x
  • Any IDE (e.g., Visual Studio Code)
  • Access to the cloud account for hosting the app.
  • Install the Serverless Framework
  • Configure your cloud credentials (e.g., AWS as the cloud provider).
  • Install the necessary dependencies based on the package.json file.

2. Extend HTTP Endpoints

    • Host the app using serverless functions (e.g., AWS Lambda).
    • Expose RESTful HTTP endpoints for each webhook event.

3. Signature Verification

  • Use the calculateHMACSHA256(payload, secret) function.
  • Compare the result with the signature in the request header using verifySignature.
  • Return 401 Unauthorized if the signatures do not match.

4. Process Webhook Payloads

  • Parse JSON payloads from Infosys Equinox Commerce microservices.
  • Extract fields like orderId, lineItems, shippingAddress.
  • Trigger appropriate logic based on the event type.

5. Implement App Logic

  • Use lightweight frameworks such as:
    • Node.js (with TypeScript)
    • Python (Flask)
    • Java (Spring Boot)
  • Integrate with third-party APIs (e.g., Avalara, Stripe).
  • Return structured responses to Infosys Equinox.

6. App Callback Configuration

  • Use access tokens for secure API calls.
  • Enable callbacks for data fetch and update operations.

7. Error Handling and Logging

  • Use services like AWS CloudWatch.
  • Implement:
    • Retry logic
    • Alerting for failures
    • Configurable log levels

8. Security and Secrets Management

  • Store secrets in AWS Secrets Manager or Parameter Store
  • Avoid hardcoding credentials
  • Use secure APIs to fetch secrets at runtime

9. App Deployment

  • Deploy using the Serverless Framework
  • Validate deployed functions and endpoints

Create App Listing in the App Marketplace (Phase 2)

Once the app is deployed, it must be registered in the Infosys Equinox App Marketplace.

Steps to Create an App Listing

  1. Create a new app under your business ID in Developer Apps.
  2. Upload a JSON file with:
    • Metadata
    • Webhook URLs
    • Supported methods (e.g., tax, payment)
    • Configuration schema
  3. Configure webhook registration via JSON upload:
    • Endpoint URL
    • Webhook type (SYNC/ASYNC)
    • Events (e.g., calculateTax, generateApiKeyAndSecret)
  4. Define scopes and roles (e.g., ROLE_TAX_ADMIN).
  5. Install the app on a store via App Marketplace Admin.
  6. Configure the app for use in relevant admin modules (e.g., Payment Admin), if applicable.

See also,

Revision History
2025-07-10 | JP – Added the content.