Zerpia Hub - Admin Panel

Active Licenses

Resellers

Executions Today

Apps

Today

0 invoices

This Month

0 invoices

This Year

0 invoices

Sales by Country

	Country	Sales	Total
Loading...

Recent Licenses

License Key	Client	App	Type	Status	Expires
Loading...

License Key	Client	LANG	Reseller	App	V.WP	Type	Status	Expires	Actions
Loading...

	Client (Reseller)	Email	Licenses	Addons	Status Summary	Since
Loading...

Name	Email	Type	API Key	Billing	Status	Licenses	Limit	Actions
Loading...

Slug	Name	Version	Status	Trial (days)	Trial	Monthly	Yearly	Actions
Loading...

Date	License	Type	Status	Time (ms)	Tokens
Loading...

Reseller

Action

From

License

Date	Reseller	License	Client	App	Action	Type	Amount
Select a filter or load logs

Reseller

From

$0.00

Total Billed

Eventos con Cobro

Por App

Breakdown by Reseller

Reseller	Created Licenses	Upgrades	Renewals	Total Events	Total Amount
Loading...

Banned Domains

Domains blocked from activating new trials

Domain	License	Product	Activated	Suspended	Reason	Banned By
Loading...

Total Invoices

Pending

$0.00

Paid

$0.00

Outstanding

Reseller

Status

From

#	Reseller	Date	Items	Total	Status	Email	Actions
Loading...

Automatic Billing System

Rules & lifecycle for reseller invoicing

Invoice Triggers

License Activation (trial → paid)
Invoice generated immediately
License Renewal (monthly/yearly)
Invoice generated 5 days before
Same-day Renewals
Combined into 1 invoice

Billing Modes

Manual

Invoice pending → email → 10 days to pay
invoice-send

Automatic

Card charged → invoice paid
paid-invoice

Charge Failed

Auto-charge fails → fallback to manual
invoice-charge-failed

Non-Payment Timeline

Day 1 invoice-send
Invoice generated + email sent

Day 7 invoice-reminder
Reminder: "3 days remaining"

Day 10 invoice-overdue-suspended
Suspend license(s) + email

Day 30 invoice-overdue-final
Final notice + mark overdue

Change Password

Current Password

New Password

Confirm New Password

Admin Information

Name

Role

Configura las API keys de los proveedores de IA. Las keys se almacenan de forma segura y encriptada.

OpenAI

Not configured

API Key

Get at platform.openai.com

Default Model

Anthropic (Claude)

Not configured

API Key

Get at console.anthropic.com

Default Model

Google Gemini

Not configured

API Key

Get at Google AI Studio

Default Model

xAI (Grok)

Not configured

API Key

Get at console.x.ai

Default Model

SEO Tools

DataForSEO

Not configured

API Credentials (Base64)

Formato: login:password codificado en Base64. Get credentials

You can generate Base64 with: btoa("email:apipassword") in the browser console

Ads AI — Platform Connections

Keyword Origin

Source for keyword research in Google Ads campaigns

DataForSEO ~$0.075/query

Google Ads API Free (requires OAuth)

Google Ads

Not configured

MCC Account ID (Manager Account)

Manager account ID from Google Ads — format: XXX-XXX-XXXX

Developer Token

Get at Google Ads API Center (inside the MCC)

OAuth Client ID

Get at Google Cloud Console

OAuth Client Secret

OAuth Refresh Token

Generate via OAuth playground or your OAuth flow

Meta (Facebook / Instagram)

Not configured

App ID

Get at Meta for Developers

App Secret

TikTok Ads

Not configured

App ID

Get at TikTok Marketing API

App Secret

Image Renderer (Docker)

Not configured

Microservice URL Playwright HTML-to-Image microservice endpoint

Auth Token

fal.ai — Flux Kontext (AI Image Generation)

Not configured

Used for AI-powered ad creative generation with identity/face preservation. Flux Kontext generates lifestyle images from a reference photo.

API Key

Get your API key from fal.ai dashboard

Model PuLID = generates NEW scenes from text, preserves only the face. Kontext = edits the original image, preserves everything.

Email Settings

Configure SMTP settings for sending emails

SMTP Host

Connection Security cPanel servers typically use SSL/TLS on port 465 or STARTTLS on port 587

SMTP Port Auto-configured by security mode. Override only if needed.

SMTP Username

SMTP Password

Sender Name Name displayed in email "From" field

Admin Notifications

Admin Email Email address to receive activation and system notifications

Test Email

Send a test email to verify your SMTP configuration is working correctly.

Send test email to

Name	Slug	Category	Languages	Status	Updated
Loading...

Template Settings

Name *

Slug *

Language	Status	Last Updated
Loading...

Bank Transfer Test Mode

Enable to show Bank Transfer option in checkout (for testing)

Stripe

Credit card payments via Stripe

TEST

LIVE

Test Mode — Using test keys. No real charges will be made.

Secret Key TEST

Publishable Key TEST

Webhook Secret TEST

Bitcoin (BTCPay Server)

Cryptocurrency payments via BTCPay

BTCPay Server URL

Store ID

API Key

Webhook Secret

Total Payments

0

Total Revenue

$0.00

Completed

0

Unique Resellers

0

Date	Reseller	Description	Method	Status	Amount	Actions
Loading...

Invoice PDF Template

Customize the HTML template used to generate invoice PDFs

Available Template Variables

Invoice & Company

{{invoiceNumber}} Invoice number

{{companyName}} Company name

{{companyStreet}} Street

{{companyCity}} City

{{companyState}} State

{{companyZipCode}} Zip code

Customer & Billing

{{customerName}} Customer name

{{customerEmail}} Email

{{customerPhone}} Phone

{{customerAddress}} Address

{{billingCompanyName}} Billing company

{{billingTaxId}} Tax ID

Dates, Amounts & Status

{{createdDate}} Issue date

{{dueDate}} Due date

{{paidDate}} Paid date

{{statusLabel}} Status

{{subtotal}} Subtotal

{{total}} Total

{{currencyPrefix}} Currency ($)

{{currentYear}} Year

Supports Handlebars syntax: {{#if variable}}, {{#each items}} for line items (with {{this.description}}, {{this.quantity}}, {{this.unitPrice}}, {{this.total}}).

App Mail Settings

Configure a separate SMTP account for application emails (SEO reports, notifications to clients). This overrides the default Email settings for app-generated emails.

SMTP Host

Connection Security cPanel servers typically use SSL/TLS on port 465 or STARTTLS on port 587

SMTP Port Auto-configured by security mode. Override only if needed.

SMTP Username

SMTP Password

Sender Name Name displayed in email "From" field

Test App Mail

Send a test email using the App Mail SMTP configuration.

Send test email to

Billing API

API credentials for the unified accounting panel. Use these to query invoices, clients, and sales data from external systems.

API Key

Not generated

Header: X-Accounting-Key

API Secret

Not generated

Header: X-Accounting-Secret

Endpoint URL

https://hub.zerpia.com/api/v1/accounting/invoices

Method: GET — Params: from, to, status, page, per_page

Google OAuth Login

Manage Google Sign-In for reseller login.

Linked Accounts

Logins Today

Logins This Week

Adoption Rate %

Callback URL

Recent Google Logins

Date	Action	Reseller	Google Email	IP	Details
Loading...

ID	Reseller Name	Reseller Email	Google Email	Google Sub	Linked At	Last Login	Status
Click "Linked Accounts" to load data.

Link a Google Account

Step 1 — Reseller ID

Step 2 — Google Email

Step 3 — Google Sub ID The unique Google account identifier (sub claim from ID token).

Recently Linked

Reseller	Google Email	Date
No recent links

Date & Time	Action	Reseller	Google Email	IP Address	Details
Click "Access Log" to load data.

API Credentials

Client ID

Client Secret

Enable "Sign in with Google" on login page

Only allows login for existing accounts that have been linked to a Google account or whose email matches a registered reseller.

Enable "Sign up with Google" on register page

Allows new users to create a reseller account directly using their Google account from the registration page.

Domain Restriction

Allowed Domain Leave blank to allow any domain. If set, only Google accounts from this domain can log in.

Current Configuration

Google Login: Loading...
Auto-Registration: Loading...
Client ID: Not set
Domain Restriction: None

Google OAuth Setup Guide

Go to Google Cloud Console
https://console.cloud.google.com/

Create or select a project
Use an existing project or create a new one for your application.

Go to APIs & Services > Credentials
Navigate to the Credentials page in your project.

Configure OAuth consent screen
Set up the consent screen with your app name and authorized domains.

Create OAuth 2.0 Client ID
Select "Web application" as the application type.

Set Authorized redirect URI
Add the following URI:
https://hub.zerpia.com/v1/oauth/google/callback

Copy Client ID and Client Secret
Google will display these after creating the credentials.

Paste them in the Settings tab
Go to the "Settings" subtab above and enter your Client ID and Client Secret.

Enable Google login
Check the "Enable Google login on login page" option and save settings.

Active Licenses

Trial Licenses

Monthly Licenses

Annual Licenses

Recent Licenses

License Key	App	Client	Type	Status	Created	Expires
Loading...

Loading apps...

Renewals

Renewal monitoring and scheduled terminations

No Invoice

services to bill

Expire in 7 days

pending invoices

Expire in 3 days

needs attention

Expire tomorrow

urgent

Terminated

services to remove

Reseller	Client	Service	Amount	Expiry	Days	Mode	Invoice
Loading...

License Key	App	Client	Type	Status	Expires	Actions
Loading...

Total Invoices

Paid

Pending

Invoice History

# Invoice	Amount	Status	Created	Due Date	Paid	Actions
Loading...

SEO Leads

New

Contacted

Converted

Total

Email	Domain	Score	Status	Date	Actions
Loading...

Account Details

Your reseller account information

Name

Member since

Invoice Information

This information will appear on your invoices

Full Name

Company Name

Tax ID

Phone

Address

Address Line 1

Address Line 2

City

State / Region

Country

Billing Mode

Choose how you want to pay

Manual

Pay via email reminders

Automatic

Auto-charge saved card

You will receive email reminders to pay manually.

Saved Card

Your payment method on file

No card saved.
Add one to enable automatic payments.

Add Card

Secure Payment Processing

Your card information is securely stored by Stripe. We never have access to your full card number.

Global Branding & Identity

In this section, you can configure your global settings, including your company name, logo, and iconography. Once these details are finalized, your brand identity will be seamlessly integrated across the entire platform. From downloaded plugins to control panels, every customer touchpoint will be 100% white-labeled, ensuring a consistent and professional experience under your own brand.

Icon (256x256)

Upload Icon

PNG, JPG or WebP. Max 2MB.

Logo (max 150px height)

Upload Logo

PNG, JPG or WebP. Max 2MB.

Author Name

Domain

Support Email

Use {year} for the current year.

API Credentials

Connect your WHMCS module or integrate via the API

API Key

API Secret

Regenerating will invalidate the current key. Update all integrations after.

WHMCS Module

Download the WHMCS provisioning module to automate license management.

Configure with your API Key and Secret shown on the left.

API Documentation

Complete guide to integrate Reseller Hub with your billing system

REST API v1

Base URL

https://hub.zerpia.com/v1

Reseller Hub is a centralized platform designed for web hosting companies and service providers who want to expand their product catalog by offering AI-powered applications to their end clients.

By integrating this module into your billing system (WHMCS, Blesta, HostBill, or any custom platform), you can automatically provision, suspend, renew, and terminate licenses through a single REST API. As we release new applications, they become available instantly through the same API and workflow.

1 Authentication

2 License Lifecycle

How your billing system interacts with Reseller Hub throughout the life of a license. The same lifecycle applies to all apps (Blog AI, Chatbot AI, etc.):

Step 1: Client purchases product  →  POST /reseller/licenses
Step 2: Payment not received  →  POST /reseller/licenses/{key}/suspend
Step 3: Payment received  →  POST /reseller/licenses/{key}/unsuspend
Step 4: Invoice paid (renewal)  →  POST /reseller/licenses/{key}/renew
Step 5: Plan upgrade (trial → paid)  →  PUT /reseller/licenses/{key}
Step 6: Service cancelled  →  POST /reseller/licenses/{key}/terminate

Multi-App: For WordPress apps (Blog AI), the client installs a plugin. For SaaS apps (Chatbot AI), the client accesses a web panel and embeds a widget via <script> tag. No WordPress required.

License Statuses

Status	Description
`active`	License is active. Plugin works normally.
`suspended`	Suspended (e.g., unpaid). Plugin blocked.
`expired`	Past expiration date. Plugin blocked.
`cancelled`	Permanently terminated.

License Types

Type	Expiration	Trial Limit
`trial`	+7 days	5 executions
`monthly`	+1 month	Unlimited
`yearly`	+1 year	Unlimited

3 License Endpoints

POST /v1/reseller/licenses Create License

Creates a new license when a client purchases a product.

Request Body (Blog AI)

{
    "app_slug": "blog-ai",
    "client_email": "client@example.com",
    "type": "monthly",
    "domain": "https://example.com",
    "external_service_id": "SVC-12345",
    "client_name": "John Doe",
    "client_company": "Acme Corp"
}

Request Body (Chatbot AI)

{
    "app_slug": "chatbot-ai",
    "client_email": "client@example.com",
    "type": "monthly",
    "domain": "https://example.com",
    "external_service_id": "SVC-12346",
    "client_name": "John Doe",
    "client_company": "Acme Corp"
}

Field	Required	Description
`app_slug`	Yes	Application identifier: `blog-ai`, `chatbot-ai`, etc.
`client_email`	Yes	End-client email address
`type`	Yes	`trial`, `monthly`, or `yearly`
`domain`	No	Client's website URL (for WordPress plugin verification and Chatbot AI widget)
`external_service_id`	No	Your billing system's service ID (for two-way mapping)
`client_name`	No	Client's full name
`client_company`	No	Client's company name

Response 201

{
    "success": true,
    "message": "License created successfully",
    "data": {
        "license_key": "ZBAI-A1B2-C3D4-E5F6-G7H8",
        "license_id": 42,
        "app": "blog-ai",
        "type": "monthly",
        "status": "active",
        "expires_at": "2026-03-07 15:30:00",
        "client_email": "client@example.com"
    }
}

Store the license_key from the response. You will need it for all subsequent operations.

Trial Blacklist: Each email can only activate one trial per app. If the email has already used a trial for that app (even if it was deleted or terminated), the API will return 409 TRIAL_ALREADY_USED. This restriction is per-app — the same email can still activate trials for other apps. To allow a new trial, the admin must remove the previous trial record from the database.

Error Response 409

{
    "success": false,
    "error": {
        "code": "TRIAL_ALREADY_USED",
        "message": "This email (client@example.com) has already used a trial for Blog AI. Only paid licenses (monthly/yearly) can be created."
    }
}

GET /v1/reseller/licenses/{license_key} Get License

Retrieves the current status and details of a license.

Response 200

{
    "success": true,
    "data": {
        "id": 42,
        "license_key": "ZBAI-A1B2-C3D4-E5F6-G7H8",
        "domain": "https://example.com",
        "type": "monthly",
        "status": "active",
        "expires_at": "2026-03-07 15:30:00",
        "wp_language": "en_US",
        "wp_plugin_version": "2.20.9",
        "created_at": "2026-02-07 15:30:00",
        "client_email": "client@example.com",
        "client_name": "John Doe",
        "onboarding_completed": 1,
        "app": {
            "slug": "blog-ai",
            "name": "Blog AI",
            "version": "2.20.9"
        }
    }
}

POST /v1/reseller/licenses/{license_key}/suspend Suspend License

Suspends a license (e.g., when an invoice is overdue). The end-client's plugin will be blocked.

Response 200

{ "success": true, "message": "License suspended successfully", "data": { "license_key": "ZBAI-...", "status": "suspended" } }

POST /v1/reseller/licenses/{license_key}/unsuspend Unsuspend License

Reactivates a previously suspended license (e.g., after payment is received).

Response 200

{ "success": true, "message": "License active successfully", "data": { "license_key": "ZBAI-...", "status": "active" } }

Trial restriction: Suspended trials cannot be unsuspended. The API will return 403 TRIAL_REACTIVATION_BLOCKED. To continue service, upgrade the license to a paid plan (PUT /v1/reseller/licenses/{key} with {"type": "monthly", "upgrade": true}) or terminate it and create a new paid license.

Error Response 403

{
    "success": false,
    "error": {
        "code": "TRIAL_REACTIVATION_BLOCKED",
        "message": "Suspended trials cannot be reactivated. Upgrade to a paid plan instead."
    }
}

POST /v1/reseller/licenses/{license_key}/terminate Terminate License

Permanently cancels a license. This action cannot be undone.

Response 200

{ "success": true, "message": "License cancelled successfully", "data": { "license_key": "ZBAI-...", "status": "cancelled" } }

Trial blacklist persists: Terminating a trial does not remove it from the trial blacklist. The same email will still be blocked from creating another trial for that app. Any pending invoices associated with this license must still be paid.

POST /v1/reseller/licenses/{license_key}/renew Renew License

Extends the license expiration. Call this when a renewal invoice is paid.

Request Body

{ "type": "monthly" }

Field	Required	Values
`type`	Yes	`monthly` or `yearly`

Smart renewal: If the license hasn't expired, the new date is calculated from the current expires_at. If already expired, it calculates from today. Trial limits are automatically cleared.

Response 200

{
    "success": true,
    "message": "License renewed successfully",
    "data": {
        "license_key": "ZBAI-A1B2-C3D4-E5F6-G7H8",
        "type": "monthly",
        "status": "active",
        "expires_at": "2026-04-07 15:30:00"
    }
}

PUT /v1/reseller/licenses/{license_key} Update / Upgrade License

Updates license properties. Supports domain changes, plan upgrades, and manual expiration adjustments.

Change domain

{ "domain": "https://new-domain.com" }

Upgrade trial → paid

{ "type": "yearly", "upgrade": true }

Set expiration

{ "expires_at": "2027-02-07 00:00:00" }

Field	Description
`domain`	New WordPress site URL (resets domain verification)
`type`	New license type: `trial`, `monthly`, `yearly`
`upgrade`	Set to `true` to calculate expiration from today (clears trial limits)
`expires_at`	Manually set the expiration date

GET /v1/reseller/licenses List Licenses

Retrieves a paginated list of all your licenses with optional filters.

Parameter	Type	Description
`page`	int	Page number (default: 1)
`per_page`	int	Results per page (max: 100, default: 20)
`status`	string	Filter: `active`, `suspended`, `expired`, `cancelled`
`app`	string	Filter by app slug: `blog-ai`, `chatbot-ai`
`search`	string	Search in license_key, domain, or email

4 Addon License Endpoints

Manage addon licenses that extend the functionality of a parent license. Addons (e.g., AI Visibility) are linked to a parent SEO AI license and share its lifecycle.

POST /v1/reseller/addon-licenses Create Addon License

Creates a new addon license linked to an existing parent SEO AI license.

Request Body

{
    "addon_slug": "ai-visibility",
    "license_key": "SERP-XXXX-XXXX-XXXX-XXXX",
    "type": "monthly"
}

Field	Required	Description
`addon_slug`	Yes	Addon identifier: `ai-visibility`
`license_key`	Yes	Parent SEO AI license key (`SERP-XXXX-...`)
`type`	No	`monthly` or `yearly` (default: `monthly`)

Response 201

{
    "success": true,
    "data": {
        "id": 42,
        "license_key": "AIVI-XXXX-XXXX-XXXX-XXXX",
        "addon": "ai-visibility",
        "max_slots": 5,
        "type": "monthly",
        "expires_at": "2026-04-11 00:00:00"
    }
}

GET /v1/reseller/addon-licenses/{key} Get Addon License

Retrieves full details of an addon license including its associated domains.

Response 200

{
    "success": true,
    "data": {
        "id": 42,
        "license_key": "AIVI-XXXX-XXXX-XXXX-XXXX",
        "addon": "ai-visibility",
        "parent_license_key": "SERP-XXXX-XXXX-XXXX-XXXX",
        "status": "active",
        "type": "monthly",
        "max_slots": 5,
        "expires_at": "2026-04-11 00:00:00",
        "created_at": "2026-03-11 10:00:00",
        "domains": [
            { "domain": "example.com", "added_at": "2026-03-11 10:05:00" },
            { "domain": "another-site.com", "added_at": "2026-03-12 14:30:00" }
        ]
    }
}

PUT /v1/reseller/addon-licenses/{key} Update Addon License

Updates an addon license's type, expiration, or status.

Request Body

{
    "type": "yearly",
    "expires_at": "2027-03-11 00:00:00",
    "status": "active"
}

Field	Required	Description
`type`	No	`monthly` or `yearly`
`expires_at`	No	New expiration date (format: `YYYY-MM-DD HH:MM:SS`)
`status`	No	`active`, `suspended`, `cancelled`

POST /v1/reseller/addon-licenses/{key}/suspend Suspend Addon

Suspends an addon license. The addon functionality will be disabled for all associated domains.

Request Body (optional)

{
    "reason": "Payment overdue"
}

Response 200

{ "success": true, "message": "Addon license suspended" }

POST /v1/reseller/addon-licenses/{key}/unsuspend Unsuspend Addon

Reactivates a previously suspended addon license.

Response 200

{ "success": true, "message": "Addon license unsuspended" }

POST /v1/reseller/addon-licenses/{key}/terminate Terminate Addon

Permanently terminates an addon license. All associated domains are removed. This action cannot be undone.

Response 200

{ "success": true, "message": "Addon license terminated" }

Parent dependency: If the parent SEO AI license is suspended or terminated, all its addon licenses are also affected. Unsuspending the parent does not automatically unsuspend addons — they must be unsuspended individually.

5 White-Label Plugin

Customize the WordPress plugin with your own branding. Your clients will see your company name, logo, and support information.

Setup Flow

Step 1: Upload your icon → POST /v1/reseller/plugin/icon

Step 2: Upload your logo → POST /v1/reseller/plugin/logo

Step 3: Configure branding → PUT /v1/reseller/plugin/branding (auto-regenerates ZIP)

Step 4: Client downloads plugin → GET download.php?file={slug}/blog-ai.zip

Step 5: Plugin displays in WordPress → [Your Logo] Your Company - Blog AI

GET /v1/reseller/plugin/branding Get Branding

Retrieves your current plugin branding configuration.

Response 200

{
    "success": true,
    "data": {
        "slug": "my-company",
        "plugin_name": "Blog AI",
        "author_name": "My Company",
        "author_url": "https://my-company.com",
        "plugin_url": "https://my-company.com/blog-ai",
        "support_email": "support@my-company.com",
        "copyright": "Copyright 2026 My Company",
        "icon_url": "https://hub.zerpia.com/uploads/reseller-icons/my-company-icon.png",
        "logo_url": "https://hub.zerpia.com/uploads/reseller-logos/my-company-logo.png",
        "download_url": "https://hub.zerpia.com/download.php?file=my-company/blog-ai.zip",
        "current_version": "2.20.9",
        "needs_regeneration": false
    }
}

PUT /v1/reseller/plugin/branding Update Branding

Updates your plugin branding and automatically regenerates the plugin ZIP file.

Request Body

{
    "plugin_name": "Blog AI",
    "author_name": "My Company",
    "author_url": "https://my-company.com",
    "plugin_url": "https://my-company.com/blog-ai",
    "support_email": "support@my-company.com",
    "copyright": "Copyright {year} My Company"
}

Field	Required	Description
`slug`	No	Unique identifier used in download URLs
`plugin_name`	No	Plugin name displayed in WordPress
`author_name`	No	Author name shown in the plugin header
`author_url`	No	Author's website URL
`plugin_url`	No	Product landing page URL
`support_email`	No	Support email displayed inside the plugin
`copyright`	No	Copyright text (max 200 chars). Use `{year}` to auto-insert current year

This endpoint automatically regenerates the plugin ZIP with your updated branding.

POST /v1/reseller/plugin/icon Upload Icon

Uploads a custom icon displayed in the plugin's WordPress admin header. Accepts PNG, JPG, or WebP (max 2 MB). Auto-resized to 256x256.

cURL Example

curl -X POST https://hub.zerpia.com/v1/reseller/plugin/icon \
  -H "X-Api-Key: zrp_your_api_key" \
  -F "icon=@/path/to/icon.png"

Code	Error	Cause
400	`NO_FILE`	No file was sent
400	`INVALID_TYPE`	Unsupported format (only PNG, JPG, WebP)
400	`FILE_TOO_LARGE`	File exceeds 2 MB
400	`INVALID_IMAGE`	The file is not a valid image

POST /v1/reseller/plugin/logo Upload Logo

Uploads a header logo for the WordPress plugin sidebar. Unlike the icon (256x256 square), the logo preserves its original aspect ratio (max height: 150px). Accepts PNG, JPG, or WebP (max 2 MB).

cURL Example

curl -X POST https://hub.zerpia.com/v1/reseller/plugin/logo \
  -H "X-Api-Key: zrp_your_api_key" \
  -F "logo=@/path/to/logo.png"

Response 200

{ "success": true, "message": "Logo uploaded successfully", "data": { "logo_url": "https://hub.zerpia.com/uploads/reseller-logos/my-company-logo.png?v=1707840000" } }

Icon vs Logo: The icon (256x256 square) is used as favicon in client panels and WordPress plugins list. The logo (variable width, max 150px height) is displayed as the header image in the WordPress plugin sidebar.

Code	Error	Cause
400	`NO_FILE`	No file was sent
400	`INVALID_TYPE`	Unsupported format (only PNG, JPG, WebP)
400	`FILE_TOO_LARGE`	File exceeds 2 MB
400	`INVALID_IMAGE`	The file is not a valid image

POST /v1/reseller/plugin/regenerate Regenerate Plugin

Regenerates the plugin ZIP using your current branding. Useful when a new plugin version is released.

Response 200

{ "success": true, "data": { "message": "Plugin regenerated successfully", "download_url": "https://hub.zerpia.com/download.php?file=my-company/blog-ai.zip" } }

6 Apps / Products

Discover which applications are available in the Reseller Hub ecosystem and configure per-app settings.

GET /v1/reseller/apps List Apps

Retrieves all active applications available to your reseller account, including pricing, trial settings, and download URLs.

Response 200

{
    "success": true,
    "data": [
        {
            "slug": "blog-ai",
            "name": "Blog AI",
            "description": "AI-powered blog content generation",
            "version": "2.20.9",
            "requires_wordpress": 1,
            "default_trial_days": 7,
            "default_trial_limit": 5,
            "is_enabled": 1,
            "price_monthly": "9.99",
            "price_yearly": "99.99",
            "download_url": "https://hub.zerpia.com/download.php?file=...",
            "panel_url": null
        },
        {
            "slug": "chatbot-ai",
            "name": "Chatbot AI",
            "description": "AI chatbot for customer support",
            "version": "1.0.0",
            "requires_wordpress": 0,
            "default_trial_days": 7,
            "default_trial_limit": 10,
            "is_enabled": 1,
            "price_monthly": "14.99",
            "price_yearly": "149.99",
            "download_url": null,
            "panel_url": "https://chatbot.zerpia.com"
        },
        {
            "slug": "seo-ai",
            "name": "SEO AI",
            "description": "AI-powered SEO management panel",
            "version": "1.0.0",
            "requires_wordpress": 0,
            "default_trial_days": 7,
            "default_trial_limit": 5,
            "is_enabled": 1,
            "price_monthly": "19.99",
            "price_yearly": "199.99",
            "download_url": null,
            "panel_url": "https://seo.zerpia.com",
            "addons": [
                {
                    "slug": "ai-visibility",
                    "name": "AI Visibility",
                    "prefix": "AIVI",
                    "price_monthly": "9.99",
                    "price_yearly": "99.99"
                }
            ]
        }
    ]
}

Field	Description
`slug`	App identifier used when creating licenses (`blog-ai`, `chatbot-ai`, `seo-ai`)
`requires_wordpress`	`1` if WordPress plugin, `0` if SaaS panel
`is_enabled`	Whether this app is enabled for your account
`download_url`	Download URL for WordPress apps. `null` for SaaS apps
`panel_url`	For SaaS apps, the client panel URL. `null` for WordPress apps
`addons`	Array of available addons for this app. Only present for apps that support addons (e.g., SEO AI)

Blog AI (requires_wordpress: 1): Client installs a WordPress plugin. Chatbot AI (requires_wordpress: 0): Client accesses a web panel and embeds a widget via <script> tag.

PUT /v1/reseller/apps/{slug} Update App Settings

Updates per-app settings for your reseller account, such as a custom download URL.

Request Body

{
    "download_url": "https://my-company.com/downloads/blog-ai.zip"
}

Field	Required	Description
`download_url`	No	Custom download URL. Set to `""` to revert to default

7 Clients

Manage client records. Clients are automatically created when you provision a license, but you can also manage them directly.

GET /v1/reseller/clients List Clients

Retrieves a paginated list of all your clients.

Parameter	Type	Description
`page`	int	Page number (default: 1)
`per_page`	int	Results per page (max: 100, default: 20)
`search`	string	Search in email, name, company, or domain

Response 200

{
    "success": true,
    "data": [
        {
            "id": 10,
            "external_id": "WHMCS-42",
            "email": "client@example.com",
            "name": "John Doe",
            "company": "Acme Corp",
            "status": "active",
            "created_at": "2026-02-01 10:00:00",
            "license_count": 2
        }
    ],
    "pagination": { "total": 1, "page": 1, "per_page": 20, "total_pages": 1 }
}

POST /v1/reseller/clients Create Client

Creates a new client record. Optional — clients are automatically created when you create a license with a new client_email.

Request Body

{
    "email": "client@example.com",
    "name": "John Doe",
    "company": "Acme Corp",
    "external_id": "WHMCS-42"
}

Field	Required	Description
`email`	Yes	Client email (unique per reseller)
`name`	No	Client full name
`company`	No	Company name
`domain`	No	Primary domain
`external_id`	No	Your billing system's client ID
`metadata`	No	Arbitrary JSON metadata

GET /v1/reseller/clients/{id} Get Client

Retrieves a client's details including all their licenses.

Response 200

{
    "success": true,
    "data": {
        "id": 10,
        "email": "client@example.com",
        "name": "John Doe",
        "company": "Acme Corp",
        "metadata": { "source": "whmcs" },
        "licenses": [
            {
                "license_key": "ZBAI-A1B2-C3D4-E5F6-G7H8",
                "app_slug": "blog-ai",
                "type": "monthly",
                "status": "active",
                "expires_at": "2026-03-07 15:30:00"
            }
        ]
    }
}

8 Account & Statistics

Manage your reseller account and monitor usage across all your clients.

GET /v1/reseller/account Get Account

Retrieves your reseller account information and summary statistics.

Response 200

{
    "success": true,
    "data": {
        "account": {
            "id": 1,
            "name": "My Company",
            "brand_name": "My Company",
            "email": "admin@my-company.com",
            "status": "active"
        },
        "stats": {
            "total_clients": 15,
            "total_licenses": 23,
            "active_licenses": 20,
            "trial_licenses": 5
        },
        "apps": [
            { "slug": "blog-ai", "name": "Blog AI", "is_enabled": 1 },
            { "slug": "chatbot-ai", "name": "Chatbot AI", "is_enabled": 1 }
        ]
    }
}

PUT /v1/reseller/account Update Account

Updates your reseller account settings.

Request Body

{
    "brand_name": "New Brand Name",
    "webhook_url": "https://my-company.com/webhooks/resellerhub"
}

Field	Description
`brand_name`	Your company/brand display name
`webhook_url`	URL to receive webhook notifications
`settings`	JSON object with custom settings

GET /v1/reseller/stats Dashboard Stats

Retrieves detailed dashboard statistics including breakdowns by app and recent license activity.

Response 200

{
    "success": true,
    "data": {
        "overview": {
            "total_clients": 15,
            "total_licenses": 23,
            "active_licenses": 20,
            "suspended_licenses": 1,
            "expired_licenses": 2,
            "active_trials": 5
        },
        "by_app": [
            { "slug": "blog-ai", "name": "Blog AI", "total": 18, "active": 16 }
        ],
        "recent_licenses": [
            {
                "license_key": "ZBAI-...",
                "type": "monthly",
                "status": "active",
                "created_at": "2026-02-15 10:00:00",
                "email": "client@example.com",
                "app_name": "Blog AI"
            }
        ]
    }
}

GET /v1/reseller/stats/usage Usage Statistics

Retrieves execution usage statistics with daily breakdown. Useful for monitoring AI consumption.

Parameter	Type	Description
`period`	int	Number of days to look back (max: 365, default: 30)

Response 200

{
    "success": true,
    "data": {
        "period_days": 30,
        "totals": {
            "executions": 142,
            "successful": 138,
            "failed": 4,
            "tokens_used": 2450000,
            "estimated_cost": 12.35
        },
        "daily": [
            {
                "date": "2026-02-15",
                "app_slug": "blog-ai",
                "executions": 8,
                "successful": 8,
                "failed": 0,
                "tokens_used": 125000,
                "estimated_cost": 0.62
            }
        ]
    }
}

9 Error Handling

All error responses follow a consistent format:

{
    "success": false,
    "error": {
        "message": "Human-readable error description",
        "code": "ERROR_CODE"
    }
}

HTTP Status Codes

Code	Meaning
`200`	Success
`201`	Resource created
`400`	Bad request (invalid data, duplicate action)
`401`	Unauthorized (invalid API key or license key)
`403`	Forbidden (reseller suspended, license limit reached)
`404`	Resource not found
`422`	Validation error (missing required fields)
`500`	Internal server error

Common Error Codes

Error Code	Description
`RESELLER_SUSPENDED`	Your reseller account is suspended
`LICENSE_LIMIT_REACHED`	You have reached your maximum license quota
`APP_NOT_FOUND`	The app does not exist or your account lacks access
`ALREADY_SUSPENDED`	License is already suspended
`ALREADY_ACTIVE`	License is already active

10 SEO Quick Audit — Lead Capture

Embed a free SEO audit widget on your website to capture leads. When visitors enter their domain, they get an instant SEO report — and you capture their email as a qualified lead.

Lead Capture Flow

Step 1: Visitor enters domain on your website

Step 2: Quick audit runs via → POST /v1/seo-leads/audit

Step 3: Full crawl starts → POST /v1/seo-leads/start-audit

Step 4: Results shown, visitor enters email

Step 5: Lead captured → POST /v1/seo-leads/capture

Step 6: You manage leads in your panel or via API

Public endpoints: The audit and capture endpoints do NOT require authentication. Use the ref parameter with your reseller slug to associate leads with your account.

POST /v1/seo-leads/audit Quick PageSpeed audit (instant)

curl -X POST https://hub.zerpia.com/v1/seo-leads/audit \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "ref": "your-reseller-slug"}'

POST /v1/seo-leads/start-audit Start full SEO crawl (background)

curl -X POST https://hub.zerpia.com/v1/seo-leads/start-audit \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "ref": "your-reseller-slug"}'

GET /v1/seo-leads/audit-status?domain=example.com Check crawl progress

POST /v1/seo-leads/capture Capture visitor's email after audit

curl -X POST https://hub.zerpia.com/v1/seo-leads/capture \
  -H "Content-Type: application/json" \
  -d '{"email": "client@example.com", "domain": "example.com", "ref": "your-reseller-slug", "audit_score": 72}'

Response: {"lead_id": 123, "is_existing": false}

Lead Management Requires API Key

Method	Endpoint	Description
GET	`/v1/reseller/leads`	List captured leads (paginated, filterable by status)
PUT	`/v1/reseller/leads/{id}`	Update lead status: `new`, `contacted`, `converted`, `dismissed`
DELETE	`/v1/reseller/leads/{id}`	Delete a lead
GET	`/v1/reseller/audit-blacklist`	List blacklisted domains
DELETE	`/v1/reseller/audit-blacklist/{id}`	Remove domain from blacklist

Protection: Each domain can only be audited once (blacklisted after). Each IP is limited to 2 audits per day. Email must be unique across all leads.

White-Label Option Optional

By default, the audit page is hosted at hub.zerpia.com. If you want a fully white-labeled experience where no Zerpia branding is visible in the URL or source code, you can request a custom subdomain (e.g., audit.yourdomain.com). Contact your account manager to set this up — we will configure the DNS and deploy a branded version under your domain.

10 Important Notes

External Service ID — Use external_service_id to store your billing system's service ID when creating a license. This enables two-way tracking.

Client Deduplication — If you create a license with a client_email that already exists under your reseller account, the existing client record is reused.

Smart Renewal — The /renew endpoint calculates expiration from the current expires_at if not yet expired, or from today if already expired.

Trial Upgrade — When upgrading with "upgrade": true, trial limits are automatically cleared and status is set to active.

License Quota — Each reseller has a max_licenses limit. When reached, POST /licenses returns 403 with LICENSE_LIMIT_REACHED.

Future Apps — As new applications are added to the Reseller Hub ecosystem, they will be available through the same API. Simply use a different app_slug when creating licenses.

WordPress vs SaaS Apps — WordPress apps (requires_wordpress: 1, e.g., Blog AI) require a plugin download. SaaS apps (requires_wordpress: 0, e.g., Chatbot AI) use a web panel at panel_url and embed via <script> tag.

Chatbot AI Integration — When you create a chatbot-ai license, the client receives a CBAI-XXXX-XXXX-XXXX-XXXX key. They use this key to access the Chatbot AI management panel where they can configure their AI chatbot, train it, manage conversations, and get the widget embed code.

License Key Prefixes — Each product type has a unique prefix: ZBAI (Blog AI), CBAI (Chatbot AI), SERP (SEO AI), AIVI (AI Visibility addon). Addon licenses use the AIVI prefix and are managed via /v1/reseller/addon-licenses endpoints.

Addon License Lifecycle — Addon licenses (e.g., AI Visibility) are always linked to a parent license (e.g., SEO AI). Suspending or terminating the parent license also affects all its addons. Addon licenses have their own suspend/unsuspend/terminate endpoints and can be managed independently, but they cannot exist without an active parent.

Dashboard

Sales by Country

Recent Licenses

Licenses

Breakdown by Reseller

Ban Domain

Automatic Billing System

Change Password

Admin Information

OpenAI

Anthropic (Claude)

Google Gemini

xAI (Grok)

SEO Tools

DataForSEO

Ads AI — Platform Connections

Keyword Origin

Google Ads

Meta (Facebook / Instagram)

TikTok Ads

Image Renderer (Docker)

fal.ai — Flux Kontext (AI Image Generation)

Email Settings

Admin Notifications

Test Email

Bank Transfer Test Mode

Stripe

Bitcoin (BTCPay Server)

0

$0.00

0

0

Invoice PDF Template

Available Template Variables

Invoice & Company

Customer & Billing

Dates, Amounts & Status

App Mail Settings

Test App Mail

Billing API

Google OAuth Login

Recent Google Logins

Link a Google Account

Recently Linked

Current Configuration

Google OAuth Setup Guide

Recent Licenses

Renewals

New License

Invoice Information

Upgrade License

Upgrade AI Visibility

License Created

Invoice History

SEO Leads

Account Details

Invoice Information

Billing Mode

Saved Card

Global Settings Branding applied to all plugins and downloads

Global Settings

API Credentials

WHMCS Module

API Documentation

Select Your Country

Invoice Information

Invalid Tax ID

New App

Edit App

Add Plan

Add Addon

Edit License

Edit Addon License

New Reseller

Edit Reseller

New License

License Created

API Credentials

Confirm

Suspend Reseller