This provider enables Stripe merchants to manage certain parts of their Stripe infrastructure—products, plans, webhook endpoints—via Terraform.
Example use cases
Since Terraform 13 and the Terraform Registry, no need to download a release or compile this on your own machine (unless you really want to.) Just jump to the Basic Usage section and get going!
Clone repository anywhere:
$ git clone https://github.com/franckverrot/terraform-provider-stripe.git
Enter the provider directory and build the provider
$ cd terraform-provider-stripe
$ make compile
Or alternatively, to install it as a plugin, run
$ cd terraform-provider-stripe
$ make install
If you're building the provider, follow the instructions to install it as a plugin. After placing it into your plugins directory, run terraform init
to initialize it.
Set an environment variable, TF_VAR_stripe_api_token
to store your Stripe
API token. This helps ensure you do not accidentally commit this sensitive
token to your repository.
export TF_VAR_stripe_api_token=<your token>
Your token is now accessible in your Terraform configuration as
var.stripe_api_token
, and can be used to configure the provider.
The example below demonstrates the following operations:
terraform {
required_providers {
stripe = {
source = "franckverrot/stripe"
version = "1.8.0"
}
}
}
provider "stripe" {
# NOTE: This is populated from the `TF_VAR_stripe_api_token` environment variable.
api_token = "${var.stripe_api_token}"
}
resource "stripe_product" "my_product" {
name = "My Product"
type = "service"
}
resource "stripe_plan" "my_product_plan1" {
product = "${stripe_product.my_product.id}"
amount = 12345
interval = "month" # Options: day week month year
currency = "usd"
}
resource "stripe_webhook_endpoint" "my_endpoint" {
url = "https://mydomain.example.com/webhook"
enabled_events = [
"charge.succeeded",
"charge.failed",
"source.chargeable",
]
}
resource "stripe_coupon" "mlk_day_coupon_25pc_off" {
code = "MLK_DAY"
name = "King Sales Event"
duration = "once"
amount_off = 4200
currency = "usd" # lowercase
metadata = {
mlk = "<3"
sales = "yes"
}
max_redemptions = 1024
redeem_by = "2019-09-02T12:34:56-08:00" # RFC3339, in the future
}
[x] Products
[x] Prices
[x] Plans
[x] Coupons
id
)[x] TaxRates
id
)[x] Customer Portal
Scenario: you create something manually and would like to start managing it with Terraform instead.
This provider support a straightforward/naive import procedure, here's how you could do it for a coupon.
First, import the resource:
$ terraform import stripe_coupon.mlk_day_coupon_25pc_off MLK_DAY
...
Before importing this resource, please create its configuration in the root module. For example:
resource "stripe_coupon" "mlk_day_coupon_25pc_off" {
# (resource arguments)
}
Then after adding these lines to your Terraform file, a plan should result in:
$ terraform plan
...
-/+ stripe_coupon.mlk_day_coupon_25pc_off (new resource required)
id: "MLK_DAY" => <computed> (forces new resource)
amount_off: "4200" => "4200"
code: "" => "MLK_DAY"
created: "" => <computed>
currency: "usd" => "usd"
duration: "once" => "once"
livemode: "false" => <computed>
max_redemptions: "1024" => "1024"
metadata.%: "2" => "2"
metadata.mlk: "<3" => "<3"
metadata.sales: "yes" => "yes"
name: "King Sales Event" => "King Sales Event"
redeem_by: "" => "2019-09-02T12:34:56-08:00" (forces new resource)
times_redeemed: "0" => <computed>
valid: "true" => <computed>
Some updates might require replacing existing resources with new ones.
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.8+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin
to your $PATH
.
To compile the provider, run make
. This will build the provider and put the provider binary in the $GOPATH/bin
directory.
$ make bin
...
$ $GOPATH/bin/terraform-provider-stripe
...
Mozilla Public License Version 2.0 – Franck Verrot – Copyright 2018-2020