Store integrations

Overview

A store integration links your e-commerce platform to Cloud Bridge. When configured, your store sends a webhook on each order and Cloud Bridge processes it to deliver the purchased presets or captures to the customer's Cortex Cloud account.

Cloud Bridge supports three store providers:

Creating an integration

1. Go to Integrations in your Cloud Bridge dashboard.
2. Click New integration and choose your store provider.
3. Give it a name (e.g., "My Shopify Store").
4. Copy the Webhook URL and Signing secret that are generated.
5. Configure your store to send order webhooks to the provided URL.

Item mappings

Item mappings tell Cloud Bridge which NDSP asset to deliver for a given store product. Each mapping connects a store identifier to a preset or capture on Cortex Cloud.

Match types

Resource types

Each mapping specifies whether the NDSP asset is a preset or a capture:

• preset, a Quad Cortex preset file shared on Cortex Cloud
• capture, a neural capture shared on Cortex Cloud

{
  "matchType": "sku",
  "externalRef": "STORM-LEAD-V2",
  "resourceType": "preset",
  "resourceId": "abc123-preset-id"
}

Shopify setup

1. Create a Shopify integration in your Cloud Bridge dashboard and copy the webhook URL.
2. In your Shopify admin, go to Settings → Notifications → Webhooks.
3. Click Create webhook.
4. Set the event to Order creation (or Order payment).
5. Set the format to JSON.
6. Paste the Cloud Bridge webhook URL.
7. Save the webhook. Shopify will now send order data to Cloud Bridge automatically.

WooCommerce setup

1. Create a WooCommerce integration in your Cloud Bridge dashboard and copy the webhook URL and signing secret.
2. In your WordPress admin, go to WooCommerce → Settings → Advanced → Webhooks.
3. Click Add webhook.
4. Set Status to Active.
5. Set Topic to Order updated or Order created.
6. Set Delivery URL to the Cloud Bridge webhook URL.
7. Set Secret to the signing secret from Cloud Bridge.
8. Save the webhook.

Generic / custom store

For platforms not natively supported, use the Generic provider. Send a POST request with a JSON body and an HMAC-SHA256 signature header.

POST /api/webhooks/generic/<integrationId>
Content-Type: application/json
X-Webhook-Signature: sha256=<hmac-hex>

{
  "orderId": "order-1234",
  "customerEmail": "fan@music.com",
  "targetUsername": "cortex_user_42",
  "items": [
    {
      "sku": "STORM-LEAD-V2",
      "title": "Storm Drive Lead Preset",
      "quantity": 1
    }
  ]
}

Computing the signature

Sign the raw request body with your webhook signing secret using HMAC-SHA256 and include the hex digest in the X-Webhook-Signature header:

const crypto = require('crypto');

const signature = 'sha256=' +
  crypto.createHmac('sha256', webhookSecret)
    .update(rawBody)
    .digest('hex');

Delivery statuses

Each delivery attempt progresses through one or more statuses:

Failure resolution codes

When a delivery fails, a resolution code explains why: