stripe-rails 2.0.0.pre → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebffd01386755b4675cdbdffc65daeb686342bde1e57ac21f4a7da025fe0d6ab
-  data.tar.gz: 69341ad24b03113c1f0ca9de29cd7e644ac4ccac33decc972c205ad86010baa7
+  metadata.gz: 4e1778aaa249a48297d0f7c95ff5d893d3dcda21107d608ab6b262cf500b2a70
+  data.tar.gz: babf50def492764aba044d993a2acd8338161485dc96ae28eae8bb88dc0bc15b
 SHA512:
-  metadata.gz: 69409504a7e36670c46cbb1330b354b6e0ca78846eb5e665ef4cfa6adb5d4f247d1d39a24955edd0a61732de32c6706cc486f9c83c0770fbd8a5be71acff2cb7
-  data.tar.gz: 60c5e212ff5fd64e657148b6d55d620e595a323220423f09eabd626c79d0ffc0ee027214c54e857ad4f8c68c58f120cc068ca5705c6947262e685f92b7708b51
+  metadata.gz: 4a656096e3c1fa2988387a31b535dd879418466661e805a3351bfd6b0728c67bd9880146359d840fcffb18b50dfa940f207fb4916eede34c38685469b9060b8e
+  data.tar.gz: 812f9988e7bbc66f2eff2c433cf918c05732799bf5ecd5d9b161fa954ee7ec38a9a9715ac43332bd27782978b1c1142fcb531cd3ef053a9d61162a8822e969d5

data/.github/pull_request_template.md

@@ -1,4 +1,15 @@
 <!--
-  Please give us ~1 week to get back to you.
+  Thanks a bunch for helping out with the project!
+
+  Please remember to,
+
+  1. Add tests if they do not exist, fix em if they are breaking
+  2. Fix any issues that are stopping Code Climate from passing
+  2. Add a short description of the feature and tag yourself on Changelog.md
+
+  That's it!
+
+  Please give me ~1 week to get back to you.
+
   If you'd like to receive occasional updates, sign up for our newsletter at http://tinyletter.com/stripe-rails
 -->

data/.github/workflows/ruby.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       matrix:
         ruby: [2.5.x, 2.6.x, 2.7.x]
-        gemfile: [Gemfile, gemfiles/rails51.gemfile, gemfiles/rails52.gemfile]
+        gemfile: [Gemfile, gemfiles/rails60.gemfile, gemfiles/rails52.gemfile, gemfiles/rails51.gemfile]
     steps:
     - uses: actions/checkout@v1
     - name: Set up Ruby
@@ -33,6 +33,9 @@ jobs:
         CC_TEST_REPORTER_ID: ${{ secrets.CC_TEST_REPORTER_ID }}
         RUBY_VERSION: ${{ matrix.ruby }}
       run: |
+        if [ $RUBY_VERSION == "2.5.x" ] ;
+          then gem install bundler
+        fi
         bundle install --jobs 4 --retry 3
         bundle exec rake
         if [ `basename $BUNDLE_GEMFILE` == "Gemfile" ] && [ $RUBY_VERSION == "2.7.x" ] && [ ! -z ${CC_TEST_REPORTER_ID} ] ;

data/Changelog.md

@@ -1,6 +1,33 @@
 ## Unreleased
 
--
+- 
+
+## 2.3.0 (2021-03-08)
+
+- Adds testing for Rails 6.0
+- Add `name` attribute to coupons. Thanks @ZilvinasKucinskas!
+
+## 2.2.1 (2020-12-22)
+
+- Add payment_intent.requires_action callback, thanks @VadimLeader.
+
+## 2.2.0 (2020-12-06)
+
+- Add Prices as a configuration object. Thanks @jamesprior!
+
+## 2.1.0 (2020-10-18)
+
+- Added option to ignore missing API key and don't show any warning. Thanks @ndbroadbent!
+- Handle passing nil to signing_secret= and add tests. Thanks @martron!
+
+## 2.0.0 (2020-09-18)
+
+- Everything from on the 2.0.0.pre release
+- includes changes from the 1.10.2 release
+
+## 1.10.2 (2020-09-18)
+
+- adds missing callback `invoice.paid`. Thanks @SyborgStudios.
 
 ## 2.0.0.pre (2020-05-29)
 

data/README.md

@@ -9,7 +9,7 @@ This gem can help your rails application integrate with Stripe in the following
 
 * manage stripe configurations in a single place.
 * makes stripe.js available from the asset pipeline.
-* manage plans and coupons from within your app.
+* manage product, prices, plans and coupons from within your app.
 * painlessly receive and validate webhooks from stripe.
 
 [📫 Sign up for the Newsletter](http://tinyletter.com/stripe-rails) to receive occasional updates.
@@ -137,6 +137,14 @@ you prefer to environment variables, you can also set `STRIPE_PUBLISHABLE_KEY`:
 export STRIPE_PUBLISHABLE_KEY=pk_test_XXXYYYZZZ
 ```
 
+If no API key is provided, `stripe-rails` will show a warning: "No stripe.com API key was configured ...". You can silence this warning by setting the `ignore_missing_secret_key` option to `true`:
+
+```ruby
+# config/environments/production.rb
+# ...
+config.stripe.ignore_missing_secret_key = true
+```
+
 ### Manually set your API version (optional)
 
 If you need to test a new API version in development, you can override the version number manually.
@@ -162,6 +170,7 @@ this will generate the configuration files containing your plan and coupon defin
 ```console
 create  config/stripe/products.rb
 create  config/stripe/plans.rb
+create  config/stripe/prices.rb
 create  config/stripe/coupons.rb
 ```
 
@@ -259,17 +268,46 @@ Stripe.product :primo do |product|
 end
 ```
 
-To upload your plans and coupons onto stripe.com, run:
+And Prices:
+
+```ruby
+Stripe.price :bronze do |price|
+  # Use an existing product id to prevent a new product from
+  # getting created
+  price.product_id = Stripe::Products::PRIMO.id
+  price.billing_scheme = 'tiered'
+  price.recurring = {
+    interval: 'month',
+    usage_type: 'metered'
+  }
+
+  # Use graduated pricing tiers
+  # ref: https://stripe.com/docs/api/prices/object#price_object-tiers
+  price.tiers = [
+    {
+      unit_amount: 1500,
+      up_to: 10
+    },
+    {
+      unit_amount: 1000,
+      up_to: 'inf'
+    }
+  ]
+  price.tiers_mode = 'graduated'
+end
+````
+
+To upload your plans, products, prices and coupons onto stripe.com, run:
 
 ```sh
 rake stripe:prepare
 ```
 
-This will create any plans and coupons that do not currently exist, and treat as a NOOP any
-plans that do, so you can run this command safely as many times as you wish. Now you can
-use any of these plans in your application.
+This will create any plans, products, prices and coupons that do not currently exist, and treat as a NOOP any
+objects that already exist, so you can run this command safely as many times as you wish. Now you can
+use any of these objects in your application.
 
-NOTE: You must destroy plans manually from your stripe dashboard.
+NOTE: You must destroy plans and prices manually from your stripe dashboard.
 
 ## Stripe Elements
 

data/config/routes.rb

@@ -5,6 +5,5 @@ Rails.application.routes.draw do
 end
 
 Stripe::Engine.routes.draw do
-  resource  :ping, only: :show
   resources :events, only: :create
 end

data/gemfiles/rails60.gemfile

@@ -0,0 +1,19 @@
+source :rubygems
+
+gem 'rails', '~> 6.0.0'
+
+gem 'rake'
+gem 'responders'
+gem 'stripe'
+
+group :test do
+  gem 'mocha'
+  gem 'simplecov', require: false
+  gem 'stripe-ruby-mock'
+  gem 'webmock'
+  # Required for system tests
+  gem 'capybara'
+  gem 'puma'
+  gem 'selenium-webdriver'
+  gem 'webdrivers'
+end

data/lib/generators/stripe/install_generator.rb

@@ -6,6 +6,7 @@ module Stripe
     def copy_plans_file
       copy_file "products.rb", "config/stripe/products.rb"
       copy_file "plans.rb", "config/stripe/plans.rb"
+      copy_file "prices.rb", "config/stripe/prices.rb"
       copy_file "coupons.rb", "config/stripe/coupons.rb"
     end
   end

data/lib/generators/templates/prices.rb

@@ -0,0 +1,46 @@
+# This file contains descriptions of all your stripe prices
+
+# Example
+# Stripe::Prices::LITE.lookup_key #=> 'lite'
+
+# Prices will have a stripe generated id.  The lookup_key will match the
+# configuration below.  You can fetch the ID or object from stripe:
+#
+#    Stripe::Prices::LITE.stripe_id #=> 'price_0000sdfs2qfsdf'
+#    Stripe::Prices::LITE.stripe_object #=> #<Stripe::Price:0x3584 id=price_0000sdfs2qfsdf>...
+
+# Prices are not deletable via the API, the `reset!` method will instead
+# create a new price and transfer the lookup key to the new price.
+
+# Stripe.price :lite do |price|
+#   # Prices may belong to a product, this will create a product along with the price
+#   price.name = 'Acme as a service LITE'
+
+#   # You can also specify an existing product ID
+#   # price.product_id = Stripe::Products::PRIMO.id
+#
+#   # amount in cents. This is 6.99
+#   price.unit_amount = 699
+#
+#   # currency to use for the price (default 'usd')
+#   price.currency = 'usd'
+#
+#   price.recurring = {
+#     # interval must be either 'day', 'week', 'month' or 'year'
+#     interval: 'month',
+#     # only bill once every three months (default 1)
+#     interval_count: 3,
+#     # Must be either 'metered' or 'licensed'
+#     usage_type: 'metered',
+#     # Specifies a usage aggregation strategy for metered usage
+#     aggregate_usage: 'sum'
+#   }
+#
+# end
+
+# Once you have your prices defined, you can run
+#
+#   rake stripe:prepare
+#
+# This will export any new prices to stripe.com so that you can
+# begin using them in your API calls.

data/lib/stripe/callbacks.rb

@@ -47,6 +47,7 @@ module Stripe
     callback 'invoice.created'
     callback 'invoice.finalized'
     callback 'invoice.marked_uncollectible'
+    callback 'invoice.paid'
     callback 'invoice.payment_action_required'
     callback 'invoice.payment_failed'
     callback 'invoice.payment_succeeded'
@@ -67,6 +68,7 @@ module Stripe
     callback 'payment_intent.created'
     callback 'payment_intent.payment_failed'
     callback 'payment_intent.processing'
+    callback 'payment_intent.requires_action'
     callback 'payment_intent.succeeded'
     callback 'payment_method.attached'
     callback 'payment_method.card_automatically_updated'

data/lib/stripe/coupons.rb

@@ -3,7 +3,7 @@ module Stripe
     include ConfigurationBuilder
 
     configuration_for :coupon do
-      attr_accessor :duration, :amount_off, :currency, :duration_in_months, :max_redemptions, :percent_off, :redeem_by
+      attr_accessor :name, :duration, :amount_off, :currency, :duration_in_months, :max_redemptions, :percent_off, :redeem_by
 
       validates_presence_of :id, :duration
       validates_presence_of :duration_in_months, :if => :repeating?
@@ -25,6 +25,7 @@ module Stripe
 
       def create_options
         {
+          :name => name,
           :duration => duration,
           :percent_off => percent_off,
           :amount_off => amount_off,

data/lib/stripe/engine.rb

@@ -8,12 +8,12 @@ module Stripe
       attr_accessor :testing
     end
 
-    stripe_config = config.stripe = Struct.new(:api_base, :api_version, :secret_key, :verify_ssl_certs, :signing_secret, :signing_secrets, :publishable_key, :endpoint, :debug_js, :auto_mount, :eager_load, :open_timeout, :read_timeout) do
+    stripe_config = config.stripe = Struct.new(:api_base, :api_version, :secret_key, :ignore_missing_secret_key, :verify_ssl_certs, :signing_secret, :signing_secrets, :publishable_key, :endpoint, :debug_js, :auto_mount, :eager_load, :open_timeout, :read_timeout) do
       # for backwards compatibility treat signing_secret as an alias for signing_secrets
       def signing_secret=(value)
-        self.signing_secrets = Array(value)
+        self.signing_secrets = value.nil? ? value : Array(value)
       end
-  
+
       def signing_secret
         self.signing_secrets && self.signing_secrets.first
       end
@@ -43,7 +43,7 @@ module Stripe
       end
       secret_key = app.config.stripe.secret_key
       Stripe.api_key = secret_key unless secret_key.nil?
-      $stderr.puts <<-MSG unless Stripe.api_key
+      $stderr.puts <<-MSG unless Stripe.api_key || app.config.stripe.ignore_missing_secret_key
 No stripe.com API key was configured for environment #{::Rails.env}! this application will be
 unable to interact with stripe.com. You can set your API key with either the environment
 variable `STRIPE_SECRET_KEY` (recommended) or by setting `config.stripe.secret_key` in your
@@ -89,7 +89,7 @@ environment file directly.
     end
 
     initializer 'stripe.plans_and_coupons' do |app|
-      for configuration in %w(products plans coupons)
+      for configuration in %w(products plans coupons prices)
         path = app.root.join("config/stripe/#{configuration}.rb")
         load path if path.exist?
       end

data/lib/stripe/prices.rb

@@ -0,0 +1,189 @@
+module Stripe
+  module Prices
+    include ConfigurationBuilder
+    VALID_TIME_UNITS = %i(day week month year)
+
+    configuration_for :price do
+      attr_reader   :lookup_key
+      attr_accessor :active,
+                    :billing_scheme,
+                    :constant_name,
+                    :currency,
+                    :metadata,
+                    :name,
+                    :nickname,
+                    :object,
+                    :product_id,
+                    :recurring,
+                    :statement_descriptor,
+                    :tiers,
+                    :tiers_mode,
+                    :transform_quantity,
+                    :type,
+                    :unit_amount
+
+      validates_presence_of :id, :currency
+      validates_presence_of :unit_amount, unless: ->(p) { p.billing_scheme == 'tiered' }
+      validates_absence_of :transform_quantity, if: ->(p) { p.billing_scheme == 'tiered' }
+      validates_presence_of :tiers_mode, :tiers, if: ->(p) { p.billing_scheme == 'tiered' }
+
+      validates_numericality_of :recurring_interval_count, allow_nil: true
+
+      validates_inclusion_of  :recurring_interval,
+                              in: VALID_TIME_UNITS.collect(&:to_s),
+                              message: "'%{value}' is not one of #{VALID_TIME_UNITS.to_sentence(last_word_connector: ', or ')}",
+                              if: ->(p) { p.recurring.present? }
+
+      validates :statement_descriptor, length: { maximum: 22 }
+
+      validates :active,                    inclusion: { in: [true, false] }, allow_nil: true
+      validates :billing_scheme,            inclusion: { in: %w{ per_unit tiered } }, allow_nil: true
+      validates :recurring_aggregate_usage, inclusion: { in: %w{ sum last_during_period last_ever max } }, allow_nil: true
+      validates :recurring_usage_type,      inclusion: { in: %w{ metered licensed } }, allow_nil: true
+      validates :tiers_mode,                inclusion: { in: %w{ graduated volume } }, allow_nil: true
+
+      validate :name_or_product_id
+      validate :recurring_aggregate_usage_must_be_metered, if: ->(p) { p.recurring_aggregate_usage.present? }
+      validate :recurring_interval_count_maximum, if: ->(p) { p.recurring_interval_count.present? }
+      validate :valid_constant_name, unless: ->(p) { p.constant_name.nil? }
+
+      # validations for when using tiered billing
+      validate :tiers_must_be_array, if: ->(p) { p.tiers.present? }
+      validate :billing_scheme_must_be_tiered, if: ->(p) { p.tiers.present? }
+      validate :validate_tiers, if: ->(p) { p.billing_scheme == 'tiered' }
+
+      def initialize(*args)
+        super(*args)
+        @currency = 'usd'
+        @lookup_key = @id.to_s
+        @recurring = (recurring || {}).symbolize_keys
+      end
+
+      # We're overriding a handful of the Configuration methods so that
+      # we find and create by lookup_key instead of by ID.  The ID is assigned
+      # by stripe and out of our control
+      def put!
+        if exists?
+          puts "[EXISTS] - #{@stripe_class}:#{@id}:#{stripe_id}" unless Stripe::Engine.testing
+        else
+          object = @stripe_class.create({:lookup_key => @lookup_key}.merge compact_create_options)
+          puts "[CREATE] - #{@stripe_class}:#{object}" unless Stripe::Engine.testing
+        end
+      end
+
+      # You can't delete prices, but you can transfer the lookup key to a new price
+      def reset!
+        object = @stripe_class.create(reset_options)
+        puts "[RESET] - #{@stripe_class}:#{object}" unless Stripe::Engine.testing
+      end
+
+      def exists?
+        stripe_object.presence
+      rescue Stripe::InvalidRequestError
+        false
+      end
+
+      def stripe_object
+        @stripe_class.list({lookup_keys: [@lookup_key]}).data.first.presence || nil
+      rescue Stripe::InvalidRequestError
+        nil
+      end
+
+      def stripe_id
+        @stripe_id ||= stripe_object.try(:id)
+      end
+
+      def recurring_interval
+        recurring[:interval]
+      end
+
+      def recurring_aggregate_usage
+        recurring[:aggregate_usage]
+      end
+
+      def recurring_usage_type
+        recurring[:usage_type]
+      end
+
+      def recurring_interval_count
+        recurring[:interval_count]
+      end
+
+      private
+      def recurring_aggregate_usage_must_be_metered
+        errors.add(:recurring_aggregate_usage, 'recurring[:usage_type] must be metered') unless (recurring_usage_type == 'metered')
+      end
+
+      def recurring_interval_count_maximum
+        time_unit = recurring_interval.to_sym
+
+        return unless VALID_TIME_UNITS.include?(time_unit) && recurring_interval_count.respond_to?(time_unit)
+        too_long = recurring_interval_count.send(time_unit) > 1.year
+
+        errors.add(:recurring_interval_count, 'recurring[:interval_count] Maximum is one year (1 year, 12 months, or 52 weeks') if too_long
+      end
+
+      def name_or_product_id
+        errors.add(:base, 'must have a product_id or a name') unless (@product_id.present? ^ @name.present?)
+      end
+
+      def billing_scheme_must_be_tiered
+        errors.add(:billing_scheme, 'must be set to `tiered` when specifying `tiers`') unless billing_scheme == 'tiered'
+      end
+
+      def tiers_must_be_array
+        errors.add(:tiers, 'must be an Array') unless tiers.is_a?(Array)
+      end
+
+      def billing_tiers
+        @billing_tiers = tiers.map { |t| Stripe::Plans::BillingTier.new(t) } if tiers
+      end
+
+      def validate_tiers
+        billing_tiers.all?(&:valid?)
+      end
+
+      module ConstTester; end
+      def valid_constant_name
+        ConstTester.const_set(constant_name.to_s.upcase, constant_name)
+        ConstTester.send(:remove_const, constant_name.to_s.upcase.to_sym)
+      rescue NameError
+        errors.add(:constant_name, 'is not a valid Ruby constant name.')
+      end
+
+      def reset_options
+        existing_object = stripe_object
+        # Lookup and set the existing product ID if unset
+        @product_id ||= existing_object.product if existing_object.present?
+
+        { transfer_lookup_key: existing_object.present? }.merge(compact_create_options)
+      end
+
+      def create_options
+        {
+          currency: currency,
+          unit_amount: unit_amount,
+          active: active,
+          metadata: metadata,
+          nickname: nickname.presence || @lookup_key,
+          recurring: recurring.compact,
+          tiers: tiers ? tiers.map(&:to_h) : nil,
+          tiers_mode: tiers_mode,
+          billing_scheme: billing_scheme,
+          lookup_key: @lookup_key,
+          transform_quantity: transform_quantity,
+        }.merge(product_options).compact
+      end
+
+      def product_options
+        if product_id.present?
+          { product: product_id }
+        else
+          {
+            product_data: { name: name, statement_descriptor: statement_descriptor }
+          }
+        end
+      end
+    end
+  end
+end