First Store Setup

Overview

This guide walks you through setting up your first software product, configuring license keys, and preparing to accept orders. By the end, you will have a working digital product store.

Step 1: Add Your First Product

1. Go to Products → Software Products in the admin sidebar
2. Click Create to open the product form
3. Fill in the required fields:
   • Name — Product name customers will see (e.g., "Flint Engine Pro")
   • Slug — URL-friendly identifier (auto-generated from name)
   • Description — Product description with features and details
   • Price — Selling price in your configured currency
   • Software — Toggle ON to mark as a software product
4. Upload a product image or featured media
5. Save the product

Step 2: Configure License Settings

After creating a product, set up the licensing:

1. Go to Products → Licenses
2. Create license entries for your product
3. Set the Maximum Activations — how many devices can use each key
4. Choose a license duration (lifetime or time-limited)

Each license generates a unique key that customers use to activate the software. The activation is handled through the API:

POST /api/license/activate
{
    "key": "YOUR-LICENSE-KEY",
    "instance_id": "customer-device-id"
}

# Response: { "status": "activated", "activations_remaining": 4 }

Step 3: Test the Checkout Process

1. Visit your product page at /products/{slug}
2. Click the purchase button to go to checkout
3. Fill in test customer information
4. Complete the order at /checkout/place-order
5. Verify the order appears in Products → Orders
6. Check that a license key was assigned to the order

Step 4: Verify the License API

Test the license activation endpoint:

# Activate a license
curl -X POST https://yourdomain.com/api/license/activate \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR-LICENSE-KEY","instance_id":"test-device-001"}'

# Verify a license
curl -X POST https://yourdomain.com/api/license/verify \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR-LICENSE-KEY","instance_id":"test-device-001"}'

# Deactivate a license
curl -X POST https://yourdomain.com/api/license/deactivate \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR-LICENSE-KEY","instance_id":"test-device-001"}'

Step 5: Go Live

Before accepting real orders:

1. Verify your Settings — site name, logo, contact info, and email are correct
2. Test email notifications by placing a test order
3. Check that license activation works from the customer side
4. Review the Dashboard to see order and activity metrics

Customer Experience Flow

1. Customer visits your product page and clicks purchase
2. They complete checkout with payment details
3. Order is created and payment is processed
4. License key is generated and sent via email
5. Customer activates the software using the license key
6. You monitor orders and activations from the admin panel