Stripe Terraform-Anbieter installieren

Mit dem Stripe Terraform Provider können Sie Stripe-Ressourcen mithilfe von Infrastructure as Code verwalten. Konfigurieren Sie Produkte, Preise, Abrechnungszähler und komplexe Preispläne mit der deklarativen Terraform-Syntax. Ihre Stripe-Infrastruktur wird versionskontrolliert, reproduzierbar und überprüfbar. Informationen zur API finden Sie in der Stripe-API-Dokumentation.

Beispiel-Workflow

Bitte befolgen Sie diesen Arbeitsablauf, um ein Produkt mit einem wiederkehrenden Preis und einem Webhook-Endpoint zum Empfang von Ereignissen zu erstellen.

Erstellen Sie eine neue Terraform-Datei, main.tf:

terraform {
  required_providers {
    stripe = {
      source = "stripe/stripe"
      version = "0.1.3"
    }
  }
}

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

  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
}

Legen Sie Ihren API-Schlüssel fest:

export STRIPE_API_KEY=
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"

Vorschau und Änderungen anwenden:

terraform plan
terraform apply
terraform output

Unterstützte Ressourcen

In diesem Abschnitt finden Sie einen kurzen Überblick über die verfügbaren Ressourcen. Detaillierte Dokumentation und alle konfigurierbaren Parameter finden Sie unter Unterstützte Ressourcen.

Produktkatalog

Kernressourcen

Erweiterte nutzungsbasierte Abrechnung Private preview

Diese Ressourcen sind Teil der Billing v2 API und erfordern Zugriff auf die private Vorschau.

Datenquellen

Verwalten Sie mehrere Umgebungen mit Arbeitsbereichen

Mit Terraform-Arbeitsbereichen können Sie separate Stripe-Umgebungen (Sandbox- und Live-Modus) mit isolierten Statusdateien verwalten. Dadurch werden versehentliche Änderungen an Produktionsressourcen während der Arbeit im Test-Modus verhindert.

Einrichten von Arbeitsbereichen

Erstellen Sie Arbeitsbereiche für einen Sandbox- (Test-Modus) und einen Live-Modus:

# Create workspaces
terraform workspace new sandbox
terraform workspace new livemode

# List available workspaces
terraform workspace list

Wechseln Sie zwischen Umgebungen

Jeder Arbeitsbereich verfügt über eine eigene Statusdatei. Wechseln Sie den Arbeitsbereich und legen Sie den entsprechenden API-Schlüssel fest:

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

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