Pro License Activation & BufferCode Telemetry

MailFuz Pro features an enterprise-grade licensing subsystem connected directly to BufferCode.com licensing verification APIs.

Validating an active license unlocks automatic one-click background updates, priority customer support, and the full suite of Pro features: multi-list marketing broadcasts, 24/7 drip automation workflows, 6 cloud REST API transports, visual email designer, and subscriber engagement telemetry.

In MailFuz Pro, license management is accessible via a dedicated admin submenu:

Navigate to WP-Admin → MailFuz → License (admin.php?page=mailfuz-license).
The menu item features a distinctive blue PRO pill badge.

How to Activate Your License

sequenceDiagram
    autonumber
    actor Admin as Site Administrator
    participant MF as MailFuz Pro Controller
    participant BC as BufferCode.com API
    Admin->>MF: Enters License Key (Transaction ID) & Clicks Activate
    MF->>BC: POST /api/plugin/activate/{tx_id}/{domain}/mail-fuz-pro
    BC-->>MF: JSON payload (status: active, customer, expires, domain)
    MF->>MF: Atomically store license state & set daily revalidation transient
    MF-->>Admin: Success alert & unlocks all enterprise Pro features

Step 1: Obtain Your License Key

Log in to your BufferCode Customer Account.
Under Orders / Licenses, copy your purchase Transaction ID / License Key (format typically begins with tx_... or your order identifier).

Step 2: Enter & Validate

In your WordPress admin, go to MailFuz → License.
Paste your key into the Enter License Key input field.
Click Activate License.
The system sends an encrypted HTTPS call to https://buffercode.com/api/plugin/activate/.
Upon successful verification:
- The status badge turns green: Active.
- Your licensed domain, expiration date, and customer details are displayed.
- All Pro menus (Email Lists, Broadcasts, Automations, Emails, Email Tracking, Subscribers, Import & Export) are unlocked immediately.

License Telemetry & Status Badges

The License Manager displays real-time diagnostic telemetry:

Status Badge	State	Description
Active	`active`	Fully licensed, domain bound, entitled to automatic updates and Pro features.
Unlicensed	`unlicensed`	No key entered. Pro features remain disabled until activation.
Expired	`expired`	License validity period ended. Renew at BufferCode.com to continue receiving updates.
Revoked / Inactive	`revoked`	Key was canceled or deactivated on this domain.

Diagnostic Metrics Card

When active, the License screen details:

License Key: Masked display of your registered key.
Registered Domain: The exact normalized domain authenticated on BufferCode (e.g., https://yourdomain.com).
Expiration Date: Lifetime or specific annual renewal date.
Licensed Email: Email address associated with the purchase.
Check Status Button: Manually forces an instant re-verification with BufferCode servers, clearing any local cached state.
Deactivate License: Disassociates the license from this domain, freeing up an activation slot for staging or migration.

Automated Background Revalidation

To maintain optimal performance and eliminate unnecessary external HTTP calls during regular WordPress page loads:

MailFuz caches verified license state in the database option mailfuz_pro_license.
Re-verification is throttled via a 24-hour transient (mailfuz_pro_license_revalidated).
When the transient expires, the system performs a silent background status check against https://buffercode.com/api/plugin/status/{tx_id}/{domain}/{slug} without slowing down user interactions.

Developer Staging & Local Bypass

For local development environments, continuous integration (CI) pipelines, and Docker containers where outbound connectivity to buffercode.com is restricted, MailFuz Pro includes developer bypass constants:

Add either constant to your wp-config.php file:

// Option A: Enable developer bypass mode
define( 'MAILFUZ_PRO_DEV_LICENSE', true );

// Option B: Generic license bypass
define( 'MAILFUZ_PRO_LICENSE_BYPASS', true );

When active, the License screen displays a purple DEVELOPER BYPASS MODE badge, and all enterprise Pro features remain unlocked for testing.

Troubleshooting License Errors

1. `cURL error 28: Operation timed out`

Cause: Your web server firewall or outgoing security policy blocks external HTTPS connections to buffercode.com.
Fix: Ensure your host allows outbound HTTPS traffic on port 443 to buffercode.com.

2. `Invalid License Key or Transaction Not Found`

Cause: The key was mistyped, expired, or belongs to a different BufferCode product (e.g. WorkFuz or AdFuz).
Fix: Double-check your license key in your BufferCode customer dashboard.

3. `Domain Mismatch / Activations Exceeded`

Cause: The license has reached its maximum domain limit or is registered to another URL.
Fix: Log in to BufferCode.com to manage activations or click Deactivate on your previous installation.