API Reference

AlphaTill API

REST API documentation for license activation, check-in, and portal integration.

This is a licensing and account API. There are no merchant data endpoints (products, orders, inventory) yet — business data lives in the desktop app's local database and is reached through its own export tools, not through this API.

Base URL

https://alphatill.com

Authentication

License Key / Session / Stripe Signature

Format

JSON request & response bodies

Endpoints

POST/api/license/activate

Activate a license key on a specific machine. Returns a signed license token for offline verification.

Auth: License Key

Request Body

{ "licenseKey": "MGIT-XXXX-...", "machineId": "...", "machineName": "..." }
POST/api/license/check-in

Monthly license check-in. Validates the license is still active and returns a refreshed signed token.

Auth: License Key

Request Body

{ "licenseKey": "MGIT-XXXX-...", "machineId": "..." }
GET/api/download/latest

Returns metadata about the latest stable release — version, download URL, file size, SHA256 hash, and release notes.

Auth: None
POST/api/auth/register

Register a new customer account for the customer portal.

Auth: None

Request Body

{ "name": "...", "email": "...", "password": "...", "businessName": "..." }
GET/api/portal/licenses

Returns all licenses for the authenticated customer.

Auth: Session (NextAuth)
GET/api/portal/billing

Returns subscription details for the authenticated customer.

Auth: Session (NextAuth)
POST/api/portal/support

Submit a support ticket from the customer portal.

Auth: Session (NextAuth)

Request Body

{ "subject": "...", "message": "...", "priority": "normal|high|low" }
POST/api/stripe/webhook

Stripe webhook handler for subscription lifecycle events (checkout, payment, cancellation).

Auth: Stripe Signature

Request Body

Stripe Event Payload