How PaidCommunities Works
PaidCommunities provides a complete infrastructure for selling and managing WordPress plugins and themes. This page explains the technical details of how the platform handles licensing, updates, and customer management.
Product & License Lifecycle
Creating Your Products and Releases
In PaidCommunities, products and releases are separate but related entities:
-
Product Configuration
- Set up product details, descriptions, and images
- Configure billing plans (one-time purchases, subscriptions)
- Define domain limits (single site, unlimited sites, etc.)
- Set up product families if you offer multiple product tiers
-
Release Management
- Upload your plugin/theme ZIP file as a release
- Manage different versions of your software
- Control the rollout of updates
- Track which customers have which versions
Customer Purchase & Domain Registration
When a customer buys your product:
-
Purchase Process
- Customer completes checkout on your PaidCommunities-powered checkout page
- Payment is processed via Stripe (supporting cards, Apple Pay, Google Pay, etc.)
- A license key is generated in UUID format:
E7638FFE-B359-4FCA-B157-4835F05A398D - Customer account is automatically created at customer.paidcommunities.com
- Customer receives a fully customizable email with download link and license key
-
Domain Registration
- Customer installs your plugin/theme on their WordPress site
- They enter the license key in the registration field
- Your plugin sends a domain registration request to PaidCommunities API
- API validates the license and associates the domain with that license
- A unique secret key is generated and stored in the WordPress database
- This secret key is used for all future communication with PaidCommunities
Technical Infrastructure
License and Domain System
PaidCommunities uses a robust system to manage licenses and domains:
-
License Creation
- License is generated when a purchase is completed
- License contains limits on the number of domains that can be registered
- License has a status (active, expired, disabled) that determines functionality
-
Domain Registration
- Domains are registered and associated with a license
- Each domain registration generates a unique secret key
- This secret key is stored locally in WordPress to authenticate future requests
- Domain registrations can be added or removed as needed within license limits
Update Delivery Architecture
PaidCommunities integrates with WordPress's standard update system:
-
WordPress Update Process
- WordPress checks for updates every 12 hours by default
- During this check, your plugin uses the stored secret key to authenticate
- PaidCommunities verifies the domain registration and license status
- If the license is active and a newer release exists, update data is provided
- WordPress handles the display and installation of updates through its native system
-
Update Security
- Updates are only delivered to domains with valid registrations and active licenses
- The secret key provides secure authentication without requiring the license key for each check
- The license key is never saved in the customer's WordPress database
- All communication is encrypted via HTTPS
Security Measures
PaidCommunities prioritizes security at every step:
-
License Protection
- License keys use a standard UUID format for compatibility
- Domain secret keys provide secure authentication
- All API communication is encrypted via HTTPS
-
Update Security
- Update packages are served via secure URLs
- Downloads are only available to validated domain registrations
- WordPress's native update system handles file integrity
-
Payment Security
- All payment processing is handled by Stripe (PCI compliant)
- No credit card data is stored on PaidCommunities servers
- Checkout pages use HTTPS with the latest security protocols
Customer Self-Service Portal
PaidCommunities automatically creates a customer account for every purchase:
-
Customer App Features
- Accessible at customer.paidcommunities.com
- Displays all purchased products and licenses
- Provides download access to all purchased software
- Shows order history and subscription details
- Allows customers to update billing information
- Manages subscription renewals and cancellations
- Handles payment for orders requiring authentication
-
Benefits for Developers
- Reduces support burden by enabling customer self-service
- Streamlines subscription management and renewal processes
- Provides a professional customer experience with minimal setup
- Handles complex tasks like subscription billing updates automatically
Data & Analytics
PaidCommunities provides comprehensive data on your plugin business:
-
Customer Data
- Complete purchase history and license information
- Domain registrations for each license
- Subscription status and renewal dates
- Email engagement metrics
-
Product Analytics
- Version adoption rates across your customer base
- License registration patterns
- Update check statistics
- Revenue analytics by product, plan, and time period
Integration Capabilities
Webhooks System
PaidCommunities sends webhook notifications for key events:
- Available Events
order.created: When a new order is placedlicense.created: When a new license is generatedlicense.updated: When a license status changesdomain.created: When a domain is registered with a licenseplugin.version_check: When a version check is performed- And many more
Common Integration Use Cases
- CRM Integration: Automatically add customers to systems like HubSpot or Salesforce
- Email Marketing: Sync customers with platforms like Mailchimp or ConvertKit
- Accounting Software: Send order data to QuickBooks or Xero
- Support Systems: Provision accounts in your help desk software
- Custom Workflows: Trigger personalized onboarding sequences for new customers
With webhooks, you can perform any custom action using the distributed nature of webhook events.