Need help with terraform-provider-stripe?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

franckverrot
143 Stars 26 Forks Mozilla Public License 2.0 74 Commits 3 Opened issues

Description

A Terraform Provider for Stripe

Services available

!
?

Need anything else?

Contributors list

# 198,474
Sass
elm
stripe
terrafo...
45 commits
# 186,139
Go
contain...
Groovy
pipelin...
4 commits
# 204,423
github-...
Go
stripe
terrafo...
4 commits
# 217,136
Electro...
React
emotico...
HTML
2 commits
# 138,085
HTML
Ruby
remote-...
activer...
2 commits
# 172,992
google-...
apps-sc...
HTML
Rails
1 commit
# 297,584
termina...
Racket
Common ...
alfred-...
1 commit
# 677
Go
Continu...
continu...
HTML
1 commit
# 12,560
PHP
zend-fr...
Perl
Compose...
1 commit
# 424,304
Objecti...
c-plus-...
sdl2
gitlab-...
1 commit

Terraform Stripe Provider

This provider enables Stripe merchants to manage certain parts of their Stripe infrastructure—products, plans, webhook endpoints—via Terraform.

Example use cases * Create and update resources in a repeatable manner * Clone resources across multiple Stripe accounts (e.g. different locales or brands)

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!

Requirements

  • Terraform 0.11.x to 0.13.x
  • Go 1.8 to 1.14 (to build the provider plugin)

Building The Provider

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

Using the provider

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.

Basic Usage

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 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:

  • create a product
  • create a plan for that product
  • create a webhook endpoint for a few events
terraform {
  required_providers {
    stripe = {
      source = "franckverrot/stripe"
      version = "1.7.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 }

Supported resources

  • [x] Products
    • [x] name
    • [x] type
    • [x] active (Default: true)
    • [x] attributes (list)
    • [x] metadata (map)
    • [x] statement descriptor
    • [x] unit label
  • [x] Prices
    • [x] active (Default: true)
    • [x] currency
    • [x] metadata (map)
    • [x] nickname
    • [x] product
    • [x] recurring
    • [x] unit_amount
    • [x] billing_scheme
    • [x] unitamountdecimal
    • [x] tiers (Stripe API doesn't provide the API to update this at the moment, so the deletion should be done via dashboard page)
    • [x] tiers mode
  • [x] Plans
    • [x] active (Default: true)
    • [x] aggregate usage
    • [x] amount
    • [x] amount_decimal
    • [x] billing scheme (Default: per_unit)
    • [x] currency
    • [x] interval
    • [x] interval_count (Default: 1)
    • [x] metadata (map)
    • [x] nickname
    • [x] product
    • [x] tiers
    • [x] tiers mode
    • [x] transform_usage
    • [x] trial period days
    • [x] usage type (Default: licensed)
  • [x] Webhook Endpoints
    • [x] url
    • [x] enabled_events (list)
    • [x] connect
    • Computed:
    • secret
  • [x] Coupons
    • [x] code (aka
      id
      )
    • [x] name
    • [x] amount off
    • [x] currency
    • [x] percent off
    • [x] duration
    • [x] durationinmonths
    • [x] max redemptions
    • [x] metadata
    • [x] redeem by (should be RC3339-compliant)
    • Computed:
    • [x] valid
    • [x] created
    • [x] livemode
    • [x] times redeemed
  • [x] TaxRates
    • [x] code (aka
      id
      )
    • [x] active
    • [x] description
    • [x] display_name
    • [x] inclusive
    • [x] jurisdiction
    • [ ] DELETE API (Stripe API doesn't provide the API at the moment, so the deletion should be done via dashboard page)
    • Computed:
    • [x] created
    • [x] livemode

Importing existing resources

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" => (forces new resource) amount_off: "4200" => "4200" code: "" => "MLK_DAY" created: "" => currency: "usd" => "usd" duration: "once" => "once" livemode: "false" => 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" => valid: "true" =>

Some updates might require replacing existing resources with new ones.

Developing the Provider

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
...

License

Mozilla Public License Version 2.0 – Franck Verrot – Copyright 2018-2020

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.