stripe 3.2.0 → 5.16.0

data/test/stripe/credit_note_test.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
+
+module Stripe
+  class CreditNoteTest < Test::Unit::TestCase
+    should "be listable" do
+      credit_notes = Stripe::CreditNote.list
+      assert_requested :get, "#{Stripe.api_base}/v1/credit_notes"
+      assert credit_notes.data.is_a?(Array)
+      assert credit_notes.first.is_a?(Stripe::CreditNote)
+    end
+
+    should "be retrievable" do
+      credit_note = Stripe::CreditNote.retrieve("cn_123")
+      assert_requested :get, "#{Stripe.api_base}/v1/credit_notes/cn_123"
+      assert credit_note.is_a?(Stripe::CreditNote)
+    end
+
+    should "be creatable" do
+      credit_note = Stripe::CreditNote.create(
+        amount: 100,
+        invoice: "in_123",
+        reason: "duplicate"
+      )
+      assert_requested :post, "#{Stripe.api_base}/v1/credit_notes"
+      assert credit_note.is_a?(Stripe::CreditNote)
+    end
+
+    should "be saveable" do
+      credit_note = Stripe::CreditNote.retrieve("cn_123")
+      credit_note.metadata["key"] = "value"
+      credit_note.save
+      assert_requested :post, "#{Stripe.api_base}/v1/credit_notes/#{credit_note.id}"
+    end
+
+    should "be updateable" do
+      credit_note = Stripe::CreditNote.update("cn_123", metadata: { key: "value" })
+      assert_requested :post, "#{Stripe.api_base}/v1/credit_notes/cn_123"
+      assert credit_note.is_a?(Stripe::CreditNote)
+    end
+
+    context ".preview" do
+      should "preview a credit note" do
+        invoice = Stripe::CreditNote.preview(
+          invoice: "in_123",
+          amount: 500
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/credit_notes/preview",
+                         query: {
+                           invoice: "in_123",
+                           amount: 500,
+                         }
+        assert invoice.is_a?(Stripe::CreditNote)
+      end
+    end
+
+    context "#void_credit_note" do
+      should "void credit_note" do
+        credit_note = Stripe::CreditNote.retrieve("cn_123")
+        credit_note = credit_note.void_credit_note
+        assert_requested :post,
+                         "#{Stripe.api_base}/v1/credit_notes/#{credit_note.id}/void"
+        assert credit_note.is_a?(Stripe::CreditNote)
+      end
+    end
+
+    context ".void_credit_note" do
+      should "void credit_note" do
+        credit_note = Stripe::CreditNote.void_credit_note("cn_123")
+        assert_requested :post, "#{Stripe.api_base}/v1/credit_notes/cn_123/void"
+        assert credit_note.is_a?(Stripe::CreditNote)
+      end
+    end
+
+    context ".list_preview_line_items" do
+      should "list_preview_line_items" do
+        line_items = Stripe::CreditNote.list_preview_line_items(
+          invoice: "in_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/credit_notes/preview/lines",
+                         query: {
+                           invoice: "in_123",
+                         }
+        assert line_items.data.is_a?(Array)
+        assert line_items.data[0].is_a?(Stripe::CreditNoteLineItem)
+      end
+    end
+  end
+end

data/test/stripe/customer_balance_transaction_test.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../../test_helper", __FILE__)
+
+module Stripe
+  class CustomerBalanceTransactionTest < Test::Unit::TestCase
+    context "#resource_url" do
+      should "return a resource URL" do
+        transaction = Stripe::CustomerBalanceTransaction.construct_from(
+          id: "cbtxn_123",
+          customer: "cus_123"
+        )
+        assert_equal "/v1/customers/cus_123/balance_transactions/cbtxn_123",
+                     transaction.resource_url
+      end
+
+      should "raise without a customer" do
+        transaction = Stripe::CustomerBalanceTransaction.construct_from(id: "cbtxn_123")
+        assert_raises NotImplementedError do
+          transaction.resource_url
+        end
+      end
+    end
+
+    should "raise on #retrieve" do
+      assert_raises NotImplementedError do
+        Stripe::CustomerBalanceTransaction.retrieve("cbtxn_123")
+      end
+    end
+
+    should "raise on #update" do
+      assert_raises NotImplementedError do
+        Stripe::CustomerBalanceTransaction.update("cbtxn_123")
+      end
+    end
+  end
+end

data/test/stripe/customer_card_test.rb

@@ -1,4 +1,6 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class CustomerCardTest < Test::Unit::TestCase
@@ -8,37 +10,31 @@ module Stripe
 
     should "be listable" do
       sources = @customer.sources.list
-      assert sources.data.kind_of?(Array)
+      assert sources.data.is_a?(Array)
       # because of the terrible :wildcard nature of sources, the API stub
       # cannot currently replace this response with anything meaningful so we
       # don't assert on the type of individual items like we do in other tests
     end
 
     should "be creatable" do
-      card = @customer.sources.create(
-        source: "tok_123",
+      @customer.sources.create(
+        source: "tok_123"
       )
       assert_requested :post, "#{Stripe.api_base}/v1/customers/#{@customer.id}/sources"
-      assert card.kind_of?(Stripe::BankAccount)
     end
 
     should "be deletable" do
-      card = Stripe::Card.construct_from({
-        customer: @customer.id,
-        id: "card_123"
-      })
-      card = card.delete
+      card = Stripe::Card.construct_from(customer: @customer.id,
+                                         id: "card_123")
+      card.delete
       assert_requested :delete, "#{Stripe.api_base}/v1/customers/#{@customer.id}/sources/card_123"
-      assert card.kind_of?(Stripe::Card)
     end
 
     should "be saveable" do
-      card = Stripe::Card.construct_from({
-        customer: @customer.id,
-        id: "card_123",
-        metadata: {},
-      })
-      card.metadata['key'] = 'value'
+      card = Stripe::Card.construct_from(customer: @customer.id,
+                                         id: "card_123",
+                                         metadata: {})
+      card.metadata["key"] = "value"
       card.save
       assert_requested :post, "#{Stripe.api_base}/v1/customers/#{@customer.id}/sources/card_123"
     end

data/test/stripe/customer_test.rb

@@ -1,96 +1,124 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class CustomerTest < Test::Unit::TestCase
     should "be listable" do
       customers = Stripe::Customer.list
       assert_requested :get, "#{Stripe.api_base}/v1/customers"
-      assert customers.data.kind_of?(Array)
-      assert customers.first.kind_of?(Stripe::Customer)
+      assert customers.data.is_a?(Array)
+      assert customers.first.is_a?(Stripe::Customer)
     end
 
     should "be retrievable" do
       customer = Stripe::Customer.retrieve("cus_123")
       assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123"
-      assert customer.kind_of?(Stripe::Customer)
+      assert customer.is_a?(Stripe::Customer)
     end
 
     should "be creatable" do
       customer = Stripe::Customer.create
       assert_requested :post, "#{Stripe.api_base}/v1/customers"
-      assert customer.kind_of?(Stripe::Customer)
+      assert customer.is_a?(Stripe::Customer)
     end
 
     should "be saveable" do
       customer = Stripe::Customer.retrieve("cus_123")
-      customer.metadata['key'] = 'value'
+      customer.metadata["key"] = "value"
       customer.save
       assert_requested :post, "#{Stripe.api_base}/v1/customers/#{customer.id}"
     end
 
     should "be updateable" do
-      customer = Stripe::Customer.update("cus_123", metadata: { key: 'value' })
+      customer = Stripe::Customer.update("cus_123", metadata: { key: "value" })
       assert_requested :post, "#{Stripe.api_base}/v1/customers/cus_123"
-      assert customer.kind_of?(Stripe::Customer)
+      assert customer.is_a?(Stripe::Customer)
     end
 
-    should "be deletable" do
-      customer = Stripe::Customer.retrieve("cus_123")
-      customer = customer.delete
-      assert_requested :delete, "#{Stripe.api_base}/v1/customers/#{customer.id}"
-      assert customer.kind_of?(Stripe::Customer)
+    context "#delete" do
+      should "be deletable" do
+        customer = Stripe::Customer.retrieve("cus_123")
+        customer = customer.delete
+        assert_requested :delete, "#{Stripe.api_base}/v1/customers/#{customer.id}"
+        assert customer.is_a?(Stripe::Customer)
+      end
     end
 
-    context "#create_subscription" do
-      should "create a new subscription" do
-        customer = Stripe::Customer.retrieve("cus_123")
-        subscription = customer.create_subscription({:plan => 'silver'})
-        assert subscription.kind_of?(Stripe::Subscription)
+    context ".delete" do
+      should "be deletable" do
+        customer = Stripe::Customer.delete("cus_123")
+        assert_requested :delete, "#{Stripe.api_base}/v1/customers/cus_123"
+        assert customer.is_a?(Stripe::Customer)
       end
     end
 
-    context "#create_upcoming_invoice" do
-      should "create a new invoice" do
+    context "#delete_discount" do
+      should "delete a discount" do
         customer = Stripe::Customer.retrieve("cus_123")
-        invoice = customer.create_upcoming_invoice
-        assert invoice.kind_of?(Stripe::Invoice)
+        customer = customer.delete_discount
+        assert_requested :delete, "#{Stripe.api_base}/v1/customers/#{customer.id}/discount"
+        assert customer.is_a?(Stripe::Customer)
       end
     end
 
-    context "#update_subscription" do
-      should "update a subscription" do
-        customer = Stripe::Customer.retrieve("cus_123")
+    context ".delete_discount" do
+      should "delete a discount" do
+        discount = Stripe::Customer.delete_discount("cus_123")
+        assert_requested :delete, "#{Stripe.api_base}/v1/customers/cus_123/discount"
+        assert discount.is_a?(Stripe::Discount)
+      end
+    end
 
-        # deprecated API and not in schema
-        stub_request(:post, "#{Stripe.api_base}/v1/customers/#{customer.id}/subscription").
-          with(body: { plan: "silver" }).
-          to_return(body: JSON.generate({ object: "subscription" }))
-        subscription = customer.update_subscription({:plan => 'silver'})
-        assert subscription.kind_of?(Stripe::Subscription)
+    context "#create_source" do
+      should "create a source" do
+        Stripe::Customer.create_source(
+          "cus_123",
+          source: "tok_123"
+        )
+        assert_requested :post, "#{Stripe.api_base}/v1/customers/cus_123/sources"
       end
     end
 
-    context "#cancel_subscription" do
-      should "cancel a subscription" do
-        customer = Stripe::Customer.retrieve("cus_123")
+    context "#retrieve_source" do
+      should "retrieve a source" do
+        Stripe::Customer.retrieve_source(
+          "cus_123",
+          "ba_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123/sources/ba_123"
+      end
+    end
 
-        # deprecated API and not in schema
-        stub_request(:delete, "#{Stripe.api_base}/v1/customers/#{customer.id}/subscription").
-          with(query: { at_period_end: "true" }).
-          to_return(body: JSON.generate({ object: "subscription" }))
-        subscription = customer.cancel_subscription({:at_period_end => 'true'})
-        assert subscription.kind_of?(Stripe::Subscription)
+    context "#update_source" do
+      should "update a source" do
+        Stripe::Customer.update_source(
+          "cus_123",
+          "ba_123",
+          metadata: { foo: "bar" }
+        )
+        assert_requested :post, "#{Stripe.api_base}/v1/customers/cus_123/sources/ba_123"
       end
     end
 
-    context "#delete_discount" do
-      should "delete a discount" do
-        customer = Stripe::Customer.retrieve("cus_123")
+    context "#delete_source" do
+      should "delete a source" do
+        Stripe::Customer.delete_source(
+          "cus_123",
+          "ba_123"
+        )
+        assert_requested :delete, "#{Stripe.api_base}/v1/customers/cus_123/sources/ba_123"
+      end
+    end
 
-        stub_request(:delete, "#{Stripe.api_base}/v1/customers/#{customer.id}/discount").
-          to_return(body: JSON.generate({ object: "customer" }))
-        discount = customer.delete_discount
-        assert discount.kind_of?(Stripe::Customer)
+    context "#list_sources" do
+      should "list the customer's sources" do
+        sources = Stripe::Customer.list_sources(
+          "cus_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123/sources"
+        assert sources.is_a?(Stripe::ListObject)
+        assert sources.data.is_a?(Array)
       end
     end
 
@@ -104,11 +132,95 @@ module Stripe
       should "allow setting source with hash and set flag" do
         c = Stripe::Customer.new("test_customer")
         c.source = {
-          :object => 'card'
+          object: "card",
         }
         assert_equal true, c.source.save_with_parent
       end
     end
+
+    context "#create_tax_id" do
+      should "create a tax id" do
+        Stripe::Customer.create_tax_id(
+          "cus_123",
+          type: "eu_vat",
+          value: "11111"
+        )
+        assert_requested :post, "#{Stripe.api_base}/v1/customers/cus_123/tax_ids"
+      end
+    end
+
+    context "#retrieve_tax_id" do
+      should "retrieve a tax id" do
+        Stripe::Customer.retrieve_tax_id(
+          "cus_123",
+          "txi_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123/tax_ids/txi_123"
+      end
+    end
+
+    context "#delete_tax_id" do
+      should "delete a tax id" do
+        Stripe::Customer.delete_tax_id(
+          "cus_123",
+          "txi_123"
+        )
+        assert_requested :delete, "#{Stripe.api_base}/v1/customers/cus_123/tax_ids/txi_123"
+      end
+    end
+
+    context "#list_tax_ids" do
+      should "list the customer's tax ids" do
+        sources = Stripe::Customer.list_tax_ids(
+          "cus_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123/tax_ids"
+        assert sources.is_a?(Stripe::ListObject)
+        assert sources.data.is_a?(Array)
+      end
+    end
+
+    context "#create_balance_transaction" do
+      should "create a customer balance transaction" do
+        Stripe::Customer.create_balance_transaction(
+          "cus_123",
+          amount: 1234,
+          currency: "usd"
+        )
+        assert_requested :post, "#{Stripe.api_base}/v1/customers/cus_123/balance_transactions"
+      end
+    end
+
+    context "#retrieve_balance_transaction" do
+      should "retrieve a customer balance transaction" do
+        Stripe::Customer.retrieve_balance_transaction(
+          "cus_123",
+          "cbtxn_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123/balance_transactions/cbtxn_123"
+      end
+    end
+
+    context "#update_balance_transaction" do
+      should "update a customer balance transaction" do
+        Stripe::Customer.update_balance_transaction(
+          "cus_123",
+          "cbtxn_123",
+          description: "new"
+        )
+        assert_requested :post, "#{Stripe.api_base}/v1/customers/cus_123/balance_transactions/cbtxn_123"
+      end
+    end
+
+    context "#list_balance_transactions" do
+      should "list the customer balance transactions" do
+        sources = Stripe::Customer.list_balance_transactions(
+          "cus_123"
+        )
+        assert_requested :get, "#{Stripe.api_base}/v1/customers/cus_123/balance_transactions"
+        assert sources.is_a?(Stripe::ListObject)
+        assert sources.data.is_a?(Array)
+      end
+    end
   end
 end
-

data/test/stripe/dispute_test.rb

@@ -1,31 +1,33 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class DisputeTest < Test::Unit::TestCase
     should "be listable" do
       disputes = Stripe::Dispute.list
       assert_requested :get, "#{Stripe.api_base}/v1/disputes"
-      assert disputes.data.kind_of?(Array)
-      assert disputes.first.kind_of?(Stripe::Dispute)
+      assert disputes.data.is_a?(Array)
+      assert disputes.first.is_a?(Stripe::Dispute)
     end
 
     should "be retrievable" do
       dispute = Stripe::Dispute.retrieve("dp_123")
       assert_requested :get, "#{Stripe.api_base}/v1/disputes/dp_123"
-      assert dispute.kind_of?(Stripe::Dispute)
+      assert dispute.is_a?(Stripe::Dispute)
     end
 
     should "be saveable" do
       dispute = Stripe::Dispute.retrieve("dp_123")
-      dispute.metadata['key'] = 'value'
+      dispute.metadata["key"] = "value"
       dispute.save
       assert_requested :post, "#{Stripe.api_base}/v1/disputes/#{dispute.id}"
     end
 
     should "be updateable" do
-      dispute = Stripe::Dispute.update("dp_123", metadata: { key: 'value' })
+      dispute = Stripe::Dispute.update("dp_123", metadata: { key: "value" })
       assert_requested :post, "#{Stripe.api_base}/v1/disputes/dp_123"
-      assert dispute.kind_of?(Stripe::Dispute)
+      assert dispute.is_a?(Stripe::Dispute)
     end
 
     context "#close" do
@@ -33,7 +35,16 @@ module Stripe
         dispute = Stripe::Dispute.retrieve("dp_123")
         dispute.close
         assert_requested :post,
-          "#{Stripe.api_base}/v1/disputes/#{dispute.id}/close"
+                         "#{Stripe.api_base}/v1/disputes/#{dispute.id}/close"
+        assert dispute.is_a?(Stripe::Dispute)
+      end
+    end
+
+    context ".close" do
+      should "close a dispute" do
+        dispute = Stripe::Dispute.close("dp_123")
+        assert_requested :post, "#{Stripe.api_base}/v1/disputes/dp_123/close"
+        assert dispute.is_a?(Stripe::Dispute)
       end
     end
   end

data/test/stripe/ephemeral_key_test.rb

@@ -1,37 +1,39 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class EphemeralKeyTest < Test::Unit::TestCase
     context "#create" do
       should "succeed" do
         key = Stripe::EphemeralKey.create(
-          {customer:"cus_123"},
-          {stripe_version:"2017-05-25"}
+          { customer: "cus_123" },
+          stripe_version: "2017-05-25"
         )
 
         assert_requested(
           :post,
           "#{Stripe.api_base}/v1/ephemeral_keys",
-          headers: {'Stripe-Version' => '2017-05-25'}
+          headers: { "Stripe-Version" => "2017-05-25" }
         )
 
-        assert key.kind_of?(Stripe::EphemeralKey)
+        assert key.is_a?(Stripe::EphemeralKey)
       end
 
       context "#no global version" do
         should "use the correct api version" do
           key = Stripe::EphemeralKey.create(
-            {customer: "cus_123"},
-            {stripe_version: "2017-06-05"}
+            { customer: "cus_123" },
+            stripe_version: "2017-06-05"
           )
 
           assert_requested(
             :post,
             "#{Stripe.api_base}/v1/ephemeral_keys",
-            headers: {'Stripe-Version' => '2017-06-05'}
+            headers: { "Stripe-Version" => "2017-06-05" }
           )
 
-          assert key.kind_of?(Stripe::EphemeralKey)
+          assert key.is_a?(Stripe::EphemeralKey)
         end
 
         should "error without an explicit api version" do
@@ -53,11 +55,11 @@ module Stripe
 
         should "use the correct api version" do
           key = Stripe::EphemeralKey.create(
-            {customer: "cus_123"},
-            {stripe_version: "2017-05-25"}
+            { customer: "cus_123" },
+            stripe_version: "2017-05-25"
           )
 
-          assert key.kind_of?(Stripe::EphemeralKey)
+          assert key.is_a?(Stripe::EphemeralKey)
         end
 
         should "error without an explicit api version" do
@@ -72,13 +74,20 @@ module Stripe
     context "#delete" do
       should "succeed" do
         key = Stripe::EphemeralKey.create(
-          {customer: 'cus_123'},
-          {stripe_version: '2017-05-25'}
+          { customer: "cus_123" },
+          stripe_version: "2017-05-25"
         )
 
         key.delete
         assert_requested :delete, "#{Stripe.api_base}/v1/ephemeral_keys/#{key.id}"
       end
     end
+
+    context ".delete" do
+      should "succeed" do
+        Stripe::EphemeralKey.delete("ephkey_123")
+        assert_requested :delete, "#{Stripe.api_base}/v1/ephemeral_keys/ephkey_123"
+      end
+    end
   end
 end

data/test/stripe/errors_test.rb

@@ -1,17 +1,40 @@
-require File.expand_path('../../test_helper', __FILE__)
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
 
 module Stripe
   class StripeErrorTest < Test::Unit::TestCase
-    context "#to_s" do
-      should "convert to string" do
-        e = StripeError.new("message")
-        assert_equal "message", e.to_s
+    context "StripeError" do
+      context "#initialize" do
+        should "initialize error if json_body is set" do
+          e = StripeError.new("message", json_body: { error: { code: "some_error" } })
+          assert_not_nil e.error
+          assert_equal "some_error", e.error.code
+          assert_nil e.error.charge
+        end
+      end
+
+      context "#to_s" do
+        should "convert to string" do
+          e = StripeError.new("message")
+          assert_equal "message", e.to_s
 
-        e = StripeError.new("message", http_status: 200)
-        assert_equal "(Status 200) message", e.to_s
+          e = StripeError.new("message", http_status: 200)
+          assert_equal "(Status 200) message", e.to_s
+
+          e = StripeError.new("message", http_status: nil, http_body: nil, json_body: nil, http_headers: { "request-id" => "request-id" })
+          assert_equal "(Request request-id) message", e.to_s
+        end
+      end
+    end
 
-        e = StripeError.new("message", http_status: nil, http_body: nil, json_body: nil, http_headers: { :request_id => "request-id" })
-        assert_equal "(Request request-id) message", e.to_s
+    context "OAuth::OAuthError" do
+      context "#initialize" do
+        should "initialize error if json_body is set" do
+          e = OAuth::OAuthError.new("message", "description", json_body: { error: "some_oauth_error" })
+          assert_not_nil e.error
+          assert_equal "some_oauth_error", e.error.error
+        end
       end
     end
   end

data/test/stripe/exchange_rate_test.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require ::File.expand_path("../test_helper", __dir__)
+
+module Stripe
+  class ExchangeRateTest < Test::Unit::TestCase
+    should "be listable" do
+      list_rates = Stripe::ExchangeRate.list
+      assert_requested :get, "#{Stripe.api_base}/v1/exchange_rates"
+      assert list_rates.data.is_a?(Array)
+      assert list_rates.data.first.is_a?(Stripe::ExchangeRate)
+    end
+
+    should "be retrievable" do
+      rates = Stripe::ExchangeRate.retrieve("usd")
+      assert_requested :get, "#{Stripe.api_base}/v1/exchange_rates/usd"
+      assert rates.is_a?(Stripe::ExchangeRate)
+    end
+  end
+end