XcodeSol POS Desktop Documentation

Licensing

Licensing is handled by XcodeSol's external licensing platform. The POS application validates against that platform and unlocks only after a valid activation response.

Activation

Open the application and navigate to Settings → License. Enter:

  • License key (provided after purchase)

The application sends the activation request to the licensing API and stores a signed activation token locally.

No Domain Required

Unlike WordPress plugins, the POS desktop application does not require a domain name for activation. Only the license key is needed.

Validation Checks

The application validates the license on:

  • Initial activation
  • Application startup (with offline grace period)
  • Periodic heartbeat checks

Validation checks verify:

  • License status (active/expired)
  • Subscription or lifetime entitlement
  • Activation status
  • Update access

Offline Grace Period

The application includes a configurable offline grace period (default: 30 days). If the licensing API is temporarily unavailable, the application continues to work using the last known valid license. After the grace period expires, premium functionality remains locked until validation succeeds again.

API Endpoints

The application uses the centralized licensing API:

text
POST /activate-license
POST /validate-license
POST /deactivate-license
POST /check-updates
POST /heartbeat

License Transfer

To transfer your license to a new computer:

1. Deactivate the license on the old computer (Settings → License → Deactivate) 2. Install the application on the new computer 3. Activate with your license key

Troubleshooting

License not activating: Ensure you have a stable internet connection and that your license key is correct.

License expired: Contact XcodeSol support to renew your subscription or purchase a lifetime license.

Grace period expired: Connect to the internet and validate your license again.