🎫Issuing Your First License
Licenses are the heart of DevPayr. They determine who can use your software, where, how often, and under what conditions.
Now that your project is created, it’s time to issue your very first license. This is the key your application will validate to decide whether to run or politely refuse service.
Let’s walk through the process.
🧭 What Is a License?
A License represents one authorized installation, deployment, or usage instance of your product.
You might issue licenses for:
SaaS customers
Client projects
Plugin/theme buyers
Internal environments
Enterprise deployments
Multi-tenant app tenants
Each license is unique and comes with its own constraints.
🛠️ How to Create a License
1. Navigate to “Projects”
This opens your list of products.
2. Click “View” on the project you want to manage
You’ll enter the project dashboard.
3. Click the “New License” button
This opens the license creation form (as shown in the screenshot above).
4. Fill out the license fields
Each field controls how the license behaves. Below is a breakdown of everything:
📝 License Field Breakdown
License Title
A simple internal label to help you recognize the license.
Examples:
Premium Subscription — Maria
ClientApp License — Production
Trial License — Sandbox
It does not affect validations or functionality.
Restrict to Domain (Optional)
If your project already has domains added, you can lock this license to a specific domain.
If selected → Only this domain can use the license.
If not selected → The license can be used on any domain (subject to the domain/subdomain limits below).
💡 Tip: Perfect for client websites that must run only on the approved domain. No surprises.
Expiration Date (Optional)
Controls when the license automatically becomes invalid.
Use cases:
Trials (e.g., 7-day access)
Subscriptions (monthly/annual)
Temporary development licenses
Leave the field empty for lifetime licenses.
🌍 Domain & Usage Limits
These settings allow fine-grained control over how a license is used.
Max Domains
How many unique domains this license is allowed to operate on.
Examples:
A WordPress theme license allowing installation on 1–3 sites
A SaaS backend installed on client servers
A multi-brand setup needing a few licensed hostnames
Max Subdomains
Number of subdomains available per domain.
Useful when your app requires:
app.client.comadmin.client.comapi.client.com
Max Usage / Day
The maximum number of validation requests per day.
This is optional, but helpful for:
Trial users
Low-cost plans
Preventing abuse
Limiting automated tools
💡 Tip: If you want “fair usage,” this field is your friend.
Mark as Test License
Test licenses are relaxed versions of real licenses.
No strict domain checks
No IP/country enforcement
Ideal for local development and staging
This lets your team work without constantly worrying about environment restrictions.
🎉 Final Step: Click Create License
Once you click the button, DevPayr will generate a secure license key for you, for example:
You can now:
Give this license to your customer
Embed it in your application
Validate it from your SDK
Use it with the frontend or backend SDK
Track usage, restrictions, and activity
Congratulations — you have successfully issued your first license!
🧭 What to Do Next
Most users take one of these actions immediately after creating a license:
Validate the license (using Node, PHP, Python, or frontend SDK)
Attach domains for domain-restricted usage
Use API keys to automate license creation
Set up webhooks to listen for events like suspensions or reactivations
Last updated