Documentation
Getting Started
- Introduction
- Setup
- General Settings
- WooCommerce
- Tools
- Analytics Reports
- Dashboard
- License
- Generator
- Activations
- Applications
- Installed On
- API Logs
- WooCommerce Products
- Customer License Manager Flow
Integrations
For Developer
Node.js SDK
The Ultimate Node.js Licensing Engine for SaaS, Cloud, and Custom Software. Stop building custom Licensing APIs. This framework-agnostic SDK is the native Node.js bridge between your application and your License Manager for WooCommerce (Pro) backend.
π Accelerate Your Software Monetization
If you are building a SaaS, cloud service, or custom software, your focus should be on your productβnot building complex REST API integrations for licensing.
This SDK provides native Node.js access to the License Manager for WooCommerce (Pro) ecosystem. Integrate robust activation, validation, update, and download management into your software in minutes.
π‘οΈ Why Choose This SDK?
- Zero API Manual Coding: REST endpoints are mapped to simple asynchronous JavaScript methods.
- Framework Agnostic: Works with Express, NestJS, serverless functions, workers, CLIs, and standalone Node.js applications.
- Secure Client API: Distributed applications can use the public API without shipping WooCommerce consumer secrets.
- Enterprise Ready: Designed for license management and multi-tier SaaS fulfillment.
π Professional API Support Matrix
This SDK provides native coverage for the License Manager for WooCommerce (Pro) REST APIs.
π Core Licensing
| Feature | SDK Method | API Endpoint |
|---|---|---|
| List Licenses | client.licenses.list(params) | GET /licenses |
| Retrieve License | client.licenses.get(key) | GET /licenses/{key} |
| Create License | client.licenses.create(data) | POST /licenses |
| Update License | client.licenses.update(key, data) | PUT /licenses/{key} |
| Delete License | client.licenses.delete(key) | DELETE /licenses/{key} |
| Activate License | client.licenses.activate(key) | GET /licenses/activate/{key} |
| Reactivate License | client.licenses.reactivate(key, params) | GET /licenses/activate/{key} |
| Deactivate License | client.licenses.deactivate(key) | GET /licenses/deactivate/{key} |
| Validate License | client.licenses.validate(key) | GET /licenses/validate/{key} |
βοΈ License Generators
| Feature | SDK Method | API Endpoint |
|---|---|---|
| List Generators | client.generators.list(params) | GET /generators |
| Retrieve Generator | client.generators.get(id) | GET /generators/{id} |
| Create Generator | client.generators.create(data) | POST /generators |
| Update Generator | client.generators.update(id, data) | PUT /generators/{id} |
| Delete Generator | client.generators.delete(id) | DELETE /generators/{id} |
| Generate Keys (Pro) | client.generators.generate(id, data) | POST /generators/{id}/generate |
π Merchant & SaaS (Pro)
| Feature | SDK Method | API Endpoint |
|---|---|---|
| Customer Licenses | client.customers.getLicenses(id) | GET /customers/{id}/licenses |
| Products/Pinag | client.products.ping(data) | POST /products/ping |
| Products/Update | client.products.update(key) | GET /products/update/{key} |
| Download Products | client.products.downloadUrl(key) | GET /products/download/latest/{key} |
| Retrieve Application | client.applications.get(id) | GET /application/{id} |
| Download Application | client.applications.downloadUrl(id, token) | Signed application download URL |
π Public Client API
| Feature | SDK Method | API Endpoint |
|---|---|---|
| Activate | publicClient.activate(body) | POST /wp-json/lmfwc/v1/public/activate |
| Reactivate | publicClient.reactivate(body) | POST /wp-json/lmfwc/v1/public/reactivate |
| Deactivate | publicClient.deactivate(body) | POST /wp-json/lmfwc/v1/public/deactivate |
| Validate | publicClient.validate(body) | POST /wp-json/lmfwc/v1/public/validate |
| Installed Check | publicClient.installed(body) | POST /wp-json/lmfwc/v1/public/installed |
π The Revenue Model: Free SDK + Pro Engine
The SDK is your client-side tool to bundle with your software. To serve as the merchant backend, you must have the Pro Engine.
| Phase | Client SDK (This Free Repo) | Pro Engine (Your WooCommerce Store) |
|---|---|---|
| Purpose | Connects your Node.js application to your store. | Handles orders, payments, and keys. |
| Availability | Free for developers. | Purchase Required Here |
π¦ 3-Minute Developer Quick Start
Step 1: Install the SDK
The SDK supports Node.js 18 or newer. Add it to the project containing your package.json:
npm install lmw-sdk
Alternatively, install directly from a repository:
npm install git+https://github.com/YOUR_ORG/lmw-sdk-nodejs.git
Step 2: Initialize the client
Create the client with credentials stored in environment variables:
const { LicenseManagerClient } = require('lmw-sdk');
const client = new LicenseManagerClient({
storeUrl: process.env.LMW_STORE_URL,
consumerKey: process.env.LMW_CONSUMER_KEY,
consumerSecret: process.env.LMW_CONSUMER_SECRET,
});
3. Basic Activation Pattern
try {
const result = await client.licenses.activate(
'ABCD-1234-EFGH-5678'
);
// Store the activation token from result for future validation.
} catch (error) {
console.error('Error:', error.message);
}
The SDK supports both CommonJS and ES module imports. API methods return promises and reject when the API request fails.
ποΈ Application Integration
Express, NestJS, and Server-side Applications
Use the Pro REST API with WooCommerce consumer_key and consumer_secret credentials stored in environment variables, encrypted configuration, or a secrets manager.
Desktop, Mobile, and Distributed Software
Use the separate public client API with the product public key. Never ship the WooCommerce consumer secret in end-user software.
const { LicenseManagerPublicClient } = require('lmw-sdk');
const publicClient = new LicenseManagerPublicClient({
storeUrl: process.env.LMW_STORE_URL,
});
const result = await publicClient.validate({
public_key: process.env.LMW_PUBLIC_KEY,
license_key: 'ABCD-1234-EFGH-5678',
domain: 'my-app.example.com',
});
π Get the Pro Merchant Engine Today
Unlock 100% of the SDK’s power by upgrading to the Pro edition of License Manager for WooCommerce.