Managing HCP Terraform Billing with HCP Organizations – HashiCorp Help Center

Overview

This article explains the compatibility and limitations of managing HCP Terraform billing with HashiCorp Cloud Platform (HCP) organizations, particularly those on entitlement plans. It also outlines recommended workarounds and key considerations for various HCP and HCP Terraform subscription scenarios.

HCP Entitlement Plans and HCP Terraform Billing

HCP organizations that are on entitlement plans cannot be used to manage billing for HCP Terraform (TFC), specifically:

You cannot link a Pay-as-you-go (PAYG) Standard HCP Terraform plan to the same HCP organization that is already on an entitlement plan.
HCP Terraform entitlements and business plans are managed via HCP Terraform billing, not through HCP billing.
HCP entitlement contracts are visible in the HCP portal only because they involve HCP services like HCP Vault Dedicated or HCP Packer.
HCP Terraform contracts do not appear in the HCP portal, as they are administered separately through HCP Terraform portal.

Workaround for Using HCP Terraform PAYG with HCP

To manage a PAYG plan for HCP Terraform while your HCP organization is on an entitlement plan, follow this workaround:

A different owner of the HCP Terraform organization should create a new HCP organization.
That user can invite you to the newly created HCP organization and grant you admin permissions.
Once added, you will be able to select the new HCP organization when managing HCP Terraform plans through the "Edit Plan" option in "Planning and Billing" section in HCP Terraform portal.

Note: Each HCP organization requires a unique owner. Users are currently limited to creating only one HCP organization per account.

Flex Contract Support

HCP Flex customers have the capability to attach multiple HCP Terraform organizations to a single HCP Flex organization.
This eliminates the restriction of needing separate organizations for each HCP Terraform account.

Summary

Plan Type	Managed Through	Appears in HCP Admin	Notes
HCP Terraform Entitlement Plan	HCP Terraform Billing	No	HCP Terraform UI
HCP Terraform PAYG Plan	HCP Billing	Yes	Requires separate HCP org if entitlement plan exists
HCP Entitlement Plan	HCP Billing	Yes	Tied to HCP products like HCP Vault Dedicated, Packer
HCP Flex Plan	HCP Billing	Yes	Can attach multiple HCP Terraform orgs