Quickstart Guide

Get up and running with ValidonX in 5 minutes. By the end of this guide, you'll have created a product, issued a license key, and validated it via the API.

1. Create Your Account

Visit validonx.com/register and sign up with your email and company name. The Starter plan is free — no credit card required.

2. Provision Your Workspace

After registration, you'll be guided through the onboarding wizard:

1. Enter your company name
2. Select a plan (Starter is free)
3. Your workspace is provisioned automatically

Save your API key — it's shown only once during provisioning.

3. Create a Product

Navigate to Products in your dashboard and create your first product:

• Name: My SaaS App
• Code: my-saas-app

4. Issue a License Key

Navigate to Licenses and create a new license key for your product. The key format is: XXXX-XXXX-XXXX-XXXX (four groups of four characters, e.g. DGTU-YXN8-SAKL-5MPT).

5. Validate the License via API

curl -X POST https://api.validonx.com/api/v1/integration/licenses/XXXX-XXXX-XXXX-XXXX/validate \
  -H "X-API-Key: vx_your-api-key-here" \
  -H "Content-Type: application/json"

Response:

{
  "data": {
    "valid": true,
    "license": {
      "id": "d0999199-9a78-49ee-ba15-9132a5f5ee59",
      "key": "XXXX-XXXX-XXXX-XXXX",
      "type": "subscription",
      "status": "active",
      "expires_at": null,
      "entitlements": {
        "plan": "free"
      }
    }
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "api_version": "1"
  }
}

6. Create an Activation

Bind the license to a device. instance_id is required — it's the seat identity, so use a stable, unique value your app generates per install (not something guessable or shared). device_fingerprint is optional but recommended — a hash of hardware identifiers recorded with the activation. Because instance_id is a value your client chooses, a hardware-derived fingerprint gives each seat a device identity you can audit, so seat-sharing and device-hopping are detectable in your activation records.

curl -X POST https://api.validonx.com/api/v1/integration/activations \
  -H "X-API-Key: vx_your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "XXXX-XXXX-XXXX-XXXX",
    "instance_id": "3f9c2e1a-7b4d-4c8a-9e2f-6d1b0a5e8c74",
    "device_fingerprint": "sha256-of-hardware-identifiers",
    "metadata": {"os": "macOS", "app_version": "1.0.0"}
  }'

What's Next?

• Integration Guide — PHP and JavaScript code examples
• Entitlements & Usage — Feature flags and usage metering
• Webhook Guide — Real-time event notifications
• OpenAPI Spec — Full OpenAPI specification
• Error Codes — Complete error code reference