The Stripe Terraform Provider enables you to manage Stripe resources using infrastructure as code. Configure products, prices, billing meters, and complex pricing plans with declarative Terraform syntax. Your Stripe infrastructure becomes version controlled, reproducible, and auditable. For API details, see the Stripe API reference.

In this quickstart we will create a product with a recurring price and webhook endpoint to receive events.

Create a new Terraform file, main.tf:

terraform {
  required_providers {
    stripe = {
      source  = "stripe/stripe"
      version = ">= 0.1.0" # pin an exact version in production (e.g. "0.2.2")
    }
  }
}

provider "stripe" {
  # API key is read from STRIPE_API_KEY environment variable
  # Alternatively, set it explicitly (not recommended for production)
  # api_key = "sk_test_..."
}


# Define a product
resource "stripe_product" "pro_plan" {
  name        = "Pro Plan"
  description = "Professional tier with advanced features"
}


# Create a recurring price for the product
resource "stripe_price" "pro_monthly" {
  product     = stripe_product.pro_plan.id
  currency    = "usd"
  unit_amount = 2900  # $29.00
  
  recurring {
    interval = "month"
  }
}


# Set up a webhook endpoint for payment events
resource "stripe_webhook_endpoint" "payments" {
  url = "https://api.example.com/webhooks/stripe"
  
  enabled_events = [
    "payment_intent.succeeded",
    "payment_intent.payment_failed",
    "customer.subscription.created",
    "customer.subscription.deleted",
  ]
}

output "price_id" {
  value = stripe_price.pro_monthly.id
}

Set your API Key:

export STRIPE_API_KEY="sk_test_..."

Preview and apply changes:

terraform plan    # Preview changes
terraform apply   # Create resources in Stripe
terraform output  # View created resource IDs

Stripe also documents these in Supported resources (by provider version).

These resources are part of the V2 Billing API and require access to the private preview.

Official docs: Install the Stripe Terraform provider. The provider is published on the Terraform Registry as stripe/stripe.

• Terraform 1.0 or later
• Your Stripe API key (test mode recommended for initial setup)

Declare the provider and run terraform init. Terraform downloads signed builds from the registry automatically.

terraform {
  required_providers {
    stripe = {
      source  = "stripe/stripe"
      version = ">= 0.1.0" # pin a specific version in production
    }
  }
}

provider "stripe" {
  # API key is read from STRIPE_API_KEY by default
  # api_key = "sk_test_..." # optional; prefer the env var
}

export STRIPE_API_KEY="sk_test_..."
terraform init

Use this when contributing to the provider or testing an unreleased change. You need Go installed.

From a clone of github.com/stripe/terraform-provider-stripe:

make install

By default this installs to ~/.terraform.d/plugins/registry.terraform.io/stripe/stripe/<VERSION>/<OS>_<ARCH>/ (see VERSION in the Makefile, and run go env GOOS / go env GOARCH for the last segment). Your required_providers block must use that same version string so Terraform selects your local binary.

If you work in github.com/stripe/stripe-terraform-generator, run make install from the generator repo root; it builds from OpenAPI and installs the provider the same way.

Keep your root module separate from the provider repository. A typical layout:

my-stripe-infrastructure/
├── main.tf              # Root module
├── variables.tf
├── outputs.tf
└── terraform.tfvars     # do not commit secrets

terraform-provider-stripe/   # optional clone, for modules or local dev
└── modules/
    └── token-billing/

Reference bundled modules with a relative path into your clone:

module "my_plan" {
  source = "../terraform-provider-stripe/modules/token-billing"
  # ...
}

Alternatively, use absolute paths or vendor the module into your own repository.

Terraform workspaces allow you to manage separate Stripe environments (sandbox vs livemode) with isolated state files. This prevents accidental changes to production resources when working in test mode.

Create workspaces for sandbox (test mode) and livemode:

# Create workspaces
terraform workspace new sandbox
terraform workspace new livemode

# List available workspaces
terraform workspace list

Each workspace maintains its own state file. Switch workspaces and set the corresponding API key:

# Work in sandbox (test mode)
terraform workspace select sandbox
export STRIPE_API_KEY="sk_test_..."
terraform plan
terraform apply

# Work in livemode (production)
terraform workspace select livemode
export STRIPE_API_KEY="sk_live_..."
terraform plan
terraform apply

Modules provide simplified interfaces for common Stripe billing patterns. Instead of managing individual resources and their dependencies, configure a module with high-level parameters.

The token-billing module creates AI token-based pricing plans. It handles the coordination of multiple Stripe billing resources including pricing plans, meters, metered items, rate cards, and license fees.

Modules live under modules/ in the terraform-provider-stripe repository (for example modules/token-billing). Reference them with a relative or absolute path to that directory.

Create a pricing plan with a monthly subscription fee and usage-based pricing for AI models:

module "ai_plan" {
  source = "../terraform-provider-stripe/modules/token-billing"
  
  plan_name = "AI Pro Plan"
  
  license_fee = {
    amount = 2000  # $20.00/month
  }
  
  models = {
    "openai/gpt-4o" = {
      display_name         = "GPT-4o"
      provider             = "OpenAI"
      input_price          = 2500
      output_price         = 10000
      cached_input_price   = 1250  # 50% discount for cached tokens
      cached_output_price  = 5000
    }
    "anthropic/claude-sonnet-4.5" = {
      display_name         = "Claude Sonnet 4.5"
      provider             = "Anthropic"
      input_price          = 3000
      output_price         = 15000
      cached_input_price   = 1500
      cached_output_price  = 7500
    }
    "google/gemini-2.5-flash" = {
      display_name = "Gemini 2.5 Flash"
      provider     = "Google"
      input_price  = 300
      output_price = 2500
    }
  }
}

output "plan_id" {
  value = module.ai_plan.pricing_plan_id
}

output "meter_event_name" {
  value = module.ai_plan.meter_event_name
}

This configuration creates approximately 15 Stripe resources with correct dependencies and relationships.

Thanks for your interest in the Stripe Terraform Provider! This repository is automatically generated from Stripe's internal tooling. If you've found a bug or have a feature request, open an issue and we'll incorporate the changes through our generator.