Skip to main content

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:

  1. 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
  2. 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:

  1. 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
  2. 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:

  1. 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
  2. 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:

  1. 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
  2. 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:

  1. License Protection

    • License keys use a standard UUID format for compatibility
    • Domain secret keys provide secure authentication
    • All API communication is encrypted via HTTPS
  2. 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
  3. 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:

  1. 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
  2. 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:

  1. Customer Data

    • Complete purchase history and license information
    • Domain registrations for each license
    • Subscription status and renewal dates
    • Email engagement metrics
  2. 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:

  1. Available Events
    • order.created: When a new order is placed
    • license.created: When a new license is generated
    • license.updated: When a license status changes
    • domain.created: When a domain is registered with a license
    • plugin.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
Real-world Integration

With webhooks, you can perform any custom action using the distributed nature of webhook events.