HexaHost-GameCloud/docs/integrations/whmcs/product-mappings.md

WHMCS product mappings

Map WHMCS products (servertype=hexagamecloud) to GameCloud plan slugs without relying on product config option text fields alone.

Addon UI

Addons → HexaHost GameCloud → Mappings

1. Select a WHMCS product
2. Choose a GameCloud plan from the live catalog (GET /catalog/plans)
3. Set default Minecraft version and software family
4. Save — validated via POST /catalog/validate-plan

Mappings are stored in mod_hexagamecloud_product_mappings.

Server module behavior

On CreateAccount and ChangePackage, the provisioning module resolves:

• planSlug from mapping table (active row) or falls back to config option 1
• minecraftVersion / softwareFamily from mapping defaults or config options

Shared resolver: integrations/whmcs/lib/ProductMapping.php

Dry-run validation

Before saving, the addon calls GameCloud to ensure the plan slug exists and is active. Invalid slugs are rejected — WHMCS product names alone are never used for mapping keys.

Import / export

Mappings are WHMCS-local. Export the mod_hexagamecloud_product_mappings table for backup when migrating WHMCS hosts.