RubyGems - stripe - Versions diffs - 4.9.0 → 5.1.0 - Mend

stripe 4.9.0 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (224) hide show

checksums.yaml +4 -4
data/.editorconfig +10 -0
data/.rubocop.yml +28 -4
data/.rubocop_todo.yml +11 -22
data/.travis.yml +3 -6
data/.vscode/extensions.json +7 -0
data/.vscode/settings.json +8 -0
data/CHANGELOG.md +102 -2
data/Gemfile +2 -10
data/README.md +96 -40
data/Rakefile +8 -7
data/VERSION +1 -1
data/lib/stripe.rb +64 -85
data/lib/stripe/api_operations/delete.rb +23 -1
data/lib/stripe/api_operations/list.rb +0 -6
data/lib/stripe/api_operations/nested_resource.rb +14 -7
data/lib/stripe/api_operations/request.rb +3 -7
data/lib/stripe/api_operations/save.rb +1 -3
data/lib/stripe/api_resource.rb +50 -2
data/lib/stripe/connection_manager.rb +141 -0
data/lib/stripe/error_object.rb +94 -0
data/lib/stripe/errors.rb +22 -9
data/lib/stripe/list_object.rb +11 -5
data/lib/stripe/multipart_encoder.rb +131 -0
data/lib/stripe/object_types.rb +94 -0
data/lib/stripe/resources.rb +77 -0
data/lib/stripe/{account.rb → resources/account.rb} +49 -27
data/lib/stripe/{account_link.rb → resources/account_link.rb} +1 -1
data/lib/stripe/resources/alipay_account.rb +34 -0
data/lib/stripe/{apple_pay_domain.rb → resources/apple_pay_domain.rb} +1 -1
data/lib/stripe/resources/application_fee.rb +13 -0
data/lib/stripe/resources/application_fee_refund.rb +30 -0
data/lib/stripe/{balance.rb → resources/balance.rb} +1 -1
data/lib/stripe/{balance_transaction.rb → resources/balance_transaction.rb} +1 -5
data/lib/stripe/{bank_account.rb → resources/bank_account.rb} +14 -4
data/lib/stripe/{bitcoin_receiver.rb → resources/bitcoin_receiver.rb} +3 -3
data/lib/stripe/{bitcoin_transaction.rb → resources/bitcoin_transaction.rb} +1 -1
data/lib/stripe/resources/capability.rb +33 -0
data/lib/stripe/{card.rb → resources/card.rb} +12 -4
data/lib/stripe/resources/charge.rb +22 -0
data/lib/stripe/{checkout → resources/checkout}/session.rb +2 -2
data/lib/stripe/{country_spec.rb → resources/country_spec.rb} +1 -1
data/lib/stripe/{coupon.rb → resources/coupon.rb} +2 -2
data/lib/stripe/resources/credit_note.rb +22 -0
data/lib/stripe/resources/customer.rb +35 -0
data/lib/stripe/resources/customer_balance_transaction.rb +30 -0
data/lib/stripe/resources/discount.rb +7 -0
data/lib/stripe/{dispute.rb → resources/dispute.rb} +9 -7
data/lib/stripe/{ephemeral_key.rb → resources/ephemeral_key.rb} +5 -2
data/lib/stripe/{event.rb → resources/event.rb} +1 -1
data/lib/stripe/{exchange_rate.rb → resources/exchange_rate.rb} +1 -1
data/lib/stripe/{file.rb → resources/file.rb} +8 -11
data/lib/stripe/{file_link.rb → resources/file_link.rb} +2 -2
data/lib/stripe/resources/invoice.rb +73 -0
data/lib/stripe/{invoice_item.rb → resources/invoice_item.rb} +2 -2
data/lib/stripe/{invoice_line_item.rb → resources/invoice_line_item.rb} +1 -1
data/lib/stripe/resources/issuing/authorization.rb +33 -0
data/lib/stripe/resources/issuing/card.rb +24 -0
data/lib/stripe/{issuing → resources/issuing}/card_details.rb +1 -1
data/lib/stripe/{issuing → resources/issuing}/cardholder.rb +2 -2
data/lib/stripe/{issuing → resources/issuing}/dispute.rb +2 -2
data/lib/stripe/{issuing → resources/issuing}/transaction.rb +2 -2
data/lib/stripe/resources/login_link.rb +14 -0
data/lib/stripe/resources/order.rb +32 -0
data/lib/stripe/{order_return.rb → resources/order_return.rb} +1 -1
data/lib/stripe/resources/payment_intent.rb +42 -0
data/lib/stripe/resources/payment_method.rb +32 -0
data/lib/stripe/resources/payout.rb +22 -0
data/lib/stripe/{person.rb → resources/person.rb} +8 -3
data/lib/stripe/{plan.rb → resources/plan.rb} +1 -1
data/lib/stripe/{product.rb → resources/product.rb} +3 -3
data/lib/stripe/resources/radar/early_fraud_warning.rb +11 -0
data/lib/stripe/{radar → resources/radar}/value_list.rb +2 -2
data/lib/stripe/{radar → resources/radar}/value_list_item.rb +2 -2
data/lib/stripe/{recipient.rb → resources/recipient.rb} +2 -6
data/lib/stripe/{recipient_transfer.rb → resources/recipient_transfer.rb} +1 -1
data/lib/stripe/{refund.rb → resources/refund.rb} +1 -1
data/lib/stripe/{reporting → resources/reporting}/report_run.rb +2 -2
data/lib/stripe/{reporting → resources/reporting}/report_type.rb +2 -2
data/lib/stripe/resources/reversal.rb +29 -0
data/lib/stripe/resources/review.rb +20 -0
data/lib/stripe/resources/setup_intent.rb +32 -0
data/lib/stripe/{sigma → resources/sigma}/scheduled_query_run.rb +2 -2
data/lib/stripe/{sku.rb → resources/sku.rb} +3 -3
data/lib/stripe/{source.rb → resources/source.rb} +17 -15
data/lib/stripe/{source_transaction.rb → resources/source_transaction.rb} +1 -1
data/lib/stripe/resources/subscription.rb +25 -0
data/lib/stripe/{subscription_item.rb → resources/subscription_item.rb} +5 -2
data/lib/stripe/resources/subscription_schedule.rb +32 -0
data/lib/stripe/resources/tax_id.rb +26 -0
data/lib/stripe/resources/tax_rate.rb +11 -0
data/lib/stripe/{terminal → resources/terminal}/connection_token.rb +2 -2
data/lib/stripe/{terminal → resources/terminal}/location.rb +3 -2
data/lib/stripe/{terminal → resources/terminal}/reader.rb +3 -2
data/lib/stripe/{three_d_secure.rb → resources/three_d_secure.rb} +1 -1
data/lib/stripe/{token.rb → resources/token.rb} +1 -1
data/lib/stripe/resources/topup.rb +22 -0
data/lib/stripe/resources/transfer.rb +26 -0
data/lib/stripe/resources/usage_record.rb +7 -0
data/lib/stripe/{usage_record_summary.rb → resources/usage_record_summary.rb} +1 -1
data/lib/stripe/{webhook_endpoint.rb → resources/webhook_endpoint.rb} +2 -2
data/lib/stripe/singleton_api_resource.rb +3 -1
data/lib/stripe/stripe_client.rb +347 -218
data/lib/stripe/stripe_object.rb +72 -59
data/lib/stripe/stripe_response.rb +53 -21
data/lib/stripe/util.rb +54 -109
data/lib/stripe/version.rb +1 -1
data/lib/stripe/webhook.rb +5 -3
data/stripe.gemspec +14 -5
data/test/stripe/account_link_test.rb +1 -1
data/test/stripe/account_test.rb +193 -32
data/test/stripe/alipay_account_test.rb +1 -1
data/test/stripe/api_operations_test.rb +3 -4
data/test/stripe/api_resource_test.rb +119 -30
data/test/stripe/apple_pay_domain_test.rb +18 -5
data/test/stripe/application_fee_refund_test.rb +1 -1
data/test/stripe/application_fee_test.rb +45 -1
data/test/stripe/balance_test.rb +1 -1
data/test/stripe/balance_transaction_test.rb +20 -0
data/test/stripe/bank_account_test.rb +1 -1
data/test/stripe/capability_test.rb +45 -0
data/test/stripe/charge_test.rb +13 -8
data/test/stripe/checkout/session_test.rb +7 -1
data/test/stripe/connection_manager_test.rb +138 -0
data/test/stripe/country_spec_test.rb +1 -1
data/test/stripe/coupon_test.rb +16 -6
data/test/stripe/credit_note_test.rb +61 -0
data/test/stripe/customer_balance_transaction_test.rb +37 -0
data/test/stripe/customer_card_test.rb +1 -1
data/test/stripe/customer_test.rb +151 -40
data/test/stripe/dispute_test.rb +10 -1
data/test/stripe/ephemeral_key_test.rb +8 -1
data/test/stripe/errors_test.rb +30 -9
data/test/stripe/exchange_rate_test.rb +1 -1
data/test/stripe/file_link_test.rb +1 -1
data/test/stripe/file_test.rb +19 -5
data/test/stripe/invoice_item_test.rb +18 -7
data/test/stripe/invoice_line_item_test.rb +1 -1
data/test/stripe/invoice_test.rb +77 -9
data/test/stripe/issuing/authorization_test.rb +33 -11
data/test/stripe/issuing/card_test.rb +15 -6
data/test/stripe/issuing/cardholder_test.rb +1 -1
data/test/stripe/issuing/dispute_test.rb +1 -1
data/test/stripe/issuing/transaction_test.rb +1 -1
data/test/stripe/list_object_test.rb +1 -17
data/test/stripe/login_link_test.rb +2 -2
data/test/stripe/multipart_encoder_test.rb +130 -0
data/test/stripe/oauth_test.rb +1 -1
data/test/stripe/order_return_test.rb +1 -1
data/test/stripe/order_test.rb +28 -3
data/test/stripe/payment_intent_test.rb +31 -4
data/test/stripe/payment_method_test.rb +84 -0
data/test/stripe/payout_test.rb +8 -1
data/test/stripe/person_test.rb +1 -1
data/test/stripe/plan_test.rb +26 -20
data/test/stripe/product_test.rb +16 -6
data/test/stripe/radar/early_fraud_warning_test.rb +22 -0
data/test/stripe/radar/value_list_item_test.rb +16 -6
data/test/stripe/radar/value_list_test.rb +16 -6
data/test/stripe/recipient_test.rb +18 -5
data/test/stripe/refund_test.rb +1 -1
data/test/stripe/reporting/report_run_test.rb +1 -1
data/test/stripe/reporting/report_type_test.rb +1 -1
data/test/stripe/reversal_test.rb +1 -1
data/test/stripe/review_test.rb +1 -1
data/test/stripe/setup_intent_test.rb +84 -0
data/test/stripe/sigma/scheduled_query_run_test.rb +1 -1
data/test/stripe/sku_test.rb +16 -6
data/test/stripe/source_test.rb +14 -19
data/test/stripe/source_transaction_test.rb +1 -1
data/test/stripe/stripe_client_test.rb +242 -26
data/test/stripe/stripe_object_test.rb +8 -36
data/test/stripe/stripe_response_test.rb +71 -25
data/test/stripe/subscription_item_test.rb +28 -6
data/test/stripe/subscription_schedule_test.rb +19 -1
data/test/stripe/subscription_test.rb +29 -9
data/test/stripe/tax_id_test.rb +31 -0
data/test/stripe/tax_rate_test.rb +43 -0
data/test/stripe/terminal/connection_token_test.rb +1 -1
data/test/stripe/terminal/location_test.rb +18 -1
data/test/stripe/terminal/reader_test.rb +18 -1
data/test/stripe/three_d_secure_test.rb +1 -1
data/test/stripe/topup_test.rb +9 -1
data/test/stripe/transfer_test.rb +46 -1
data/test/stripe/usage_record_summary_test.rb +1 -1
data/test/stripe/util_test.rb +1 -1
data/test/stripe/webhook_endpoint_test.rb +18 -1
data/test/stripe/webhook_test.rb +4 -4
data/test/stripe_mock.rb +4 -3
data/test/stripe_test.rb +1 -14
data/test/test_helper.rb +14 -11
metadata +117 -125
data/lib/stripe/alipay_account.rb +0 -27
data/lib/stripe/application_fee.rb +0 -23
data/lib/stripe/application_fee_refund.rb +0 -22
data/lib/stripe/charge.rb +0 -84
data/lib/stripe/customer.rb +0 -90
data/lib/stripe/invoice.rb +0 -48
data/lib/stripe/issuer_fraud_record.rb +0 -9
data/lib/stripe/issuing/authorization.rb +0 -22
data/lib/stripe/issuing/card.rb +0 -18
data/lib/stripe/login_link.rb +0 -11
data/lib/stripe/order.rb +0 -31
data/lib/stripe/payment_intent.rb +0 -26
data/lib/stripe/payout.rb +0 -20
data/lib/stripe/reversal.rb +0 -22
data/lib/stripe/review.rb +0 -14
data/lib/stripe/subscription.rb +0 -25
data/lib/stripe/subscription_schedule.rb +0 -32
data/lib/stripe/subscription_schedule_revision.rb +0 -25
data/lib/stripe/topup.rb +0 -16
data/lib/stripe/transfer.rb +0 -23
data/lib/stripe/usage_record.rb +0 -14
data/test/stripe/account_external_accounts_operations_test.rb +0 -69
data/test/stripe/account_login_links_operations_test.rb +0 -21
data/test/stripe/account_persons_operations_test.rb +0 -70
data/test/stripe/application_fee_refunds_operations_test.rb +0 -56
data/test/stripe/customer_sources_operations_test.rb +0 -64
data/test/stripe/file_upload_test.rb +0 -76
data/test/stripe/issuer_fraud_record_test.rb +0 -20
data/test/stripe/subscription_schedule_revision_test.rb +0 -37
data/test/stripe/subscription_schedule_revisions_operations_test.rb +0 -35
data/test/stripe/transfer_reversals_operations_test.rb +0 -57
data/test/stripe/usage_record_test.rb +0 -28

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26baa8832b98118a80e495a63c9ac784ebaaf6c05a6f45470e4d2bddfd81679f
-  data.tar.gz: 06ca6de0b1b8363ebf49df745722f095bb943105dbc22d51c688c39e9e06e4b9
+  metadata.gz: 52049216e773c7f0f33c6c1b99ab895927df85cc1a818086af835e6f4ae7e3b7
+  data.tar.gz: a44404e74a7fa7834672a71aeb2ff6b56f49f1def42f9cca984fe7cc2edc486e
 SHA512:
-  metadata.gz: 9c19e6198d482addce7c6a9fd6e469a6c362139ada4926901c3e0d1704283de1b746c94c13ecee944741b8a7ad60f9acd0830bda020a3516b2a485f8e260c2ee
-  data.tar.gz: 545bd13709cb412e3c6505756eb566566d1658667c19572339811c6fd70d3425ecd0999a4d07fb1dd24bdebd5f4f4739bdf15e5a3286e058fbca1f06da884f7e
+  metadata.gz: 1f68b7b4fecb087800254fdcb9346be6c0d56fbe1494e4882f273802ab571d27f2b01d87b2466a9899ba0cb2566f209d93142883c073dda2aaecccb3e6372632
+  data.tar.gz: 97e07a834fbc3d2ecdb04f88aaa6198221aa030db6637f5404545e33d007fcb80bb23a426dbbca96eef2ed64e61167a86db671062adf58a0189ab2cccfbba410

data/.editorconfig ADDED

@@ -0,0 +1,10 @@
+# see http://editorconfig.org/
+root = true
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true

data/.rubocop.yml CHANGED

@@ -2,17 +2,32 @@ inherit_from: .rubocop_todo.yml
 AllCops:
   DisplayCopNames: true
-  TargetRubyVersion: 2.0
+  TargetRubyVersion: 2.3
 Layout/CaseIndentation:
   EnforcedStyle: end
-Layout/IndentArray:
+Layout/IndentFirstArrayElement:
   EnforcedStyle: consistent
-Layout/IndentHash:
+Layout/IndentFirstHashElement:
   EnforcedStyle: consistent
+# This can be re-enabled once we're 2.3+ only and can use the squiggly heredoc
+# operator. Prior to that, Rubocop recommended bringing in a library like
+# ActiveSupport to get heredoc indentation, which is just terrible.
+Layout/IndentHeredoc:
+  Enabled: false
+Metrics/ClassLength:
+  Exclude:
+    - "test/**/*.rb"
+Metrics/LineLength:
+  Exclude:
+    - "lib/stripe/resources/**/*.rb"
+    - "test/**/*.rb"
 Metrics/MethodLength:
   # There's ~2 long methods in `StripeClient`. If we want to truncate those a
   # little, we could move this to be closer to ~30 (but the default of 10 is
@@ -22,11 +37,20 @@ Metrics/MethodLength:
 Metrics/ModuleLength:
   Enabled: false
+Style/AccessModifierDeclarations:
+  EnforcedStyle: inline
 Style/FrozenStringLiteralComment:
   EnforcedStyle: always
+Style/NumericPredicate:
+  Enabled: false
 Style/StringLiterals:
   EnforcedStyle: double_quotes
-Style/TrailingCommaInLiteral:
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: consistent_comma
+Style/TrailingCommaInHashLiteral:
   EnforcedStyleForMultiline: consistent_comma

data/.rubocop_todo.yml CHANGED

@@ -1,50 +1,39 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2018-07-19 14:22:24 +0200 using RuboCop version 0.50.0.
+# on 2019-07-30 09:56:31 +0800 using RuboCop version 0.73.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
-# Offense count: 19
+# Offense count: 23
 Metrics/AbcSize:
-  Max: 54
+  Max: 51
-# Offense count: 27
+# Offense count: 33
 # Configuration parameters: CountComments, ExcludedMethods.
+# ExcludedMethods: refine
 Metrics/BlockLength:
-  Max: 498
+  Max: 509
-# Offense count: 8
+# Offense count: 12
 # Configuration parameters: CountComments.
 Metrics/ClassLength:
-  Max: 670
+  Max: 694
-# Offense count: 11
+# Offense count: 12
 Metrics/CyclomaticComplexity:
   Max: 15
-# Offense count: 278
-# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
-# URISchemes: http, https
-Metrics/LineLength:
-  Max: 310
 # Offense count: 6
 # Configuration parameters: CountKeywordArgs.
 Metrics/ParameterLists:
   Max: 7
-# Offense count: 5
+# Offense count: 8
 Metrics/PerceivedComplexity:
   Max: 17
-# Offense count: 2
-Style/ClassVars:
-  Exclude:
-    - 'lib/stripe/stripe_object.rb'
-    - 'test/stripe/api_resource_test.rb'
-# Offense count: 56
+# Offense count: 86
 Style/Documentation:
   Enabled: false

data/.travis.yml CHANGED

@@ -1,12 +1,11 @@
 language: ruby
 rvm:
-  - 2.1
-  - 2.2
   - 2.3
   - 2.4
   - 2.5
-  - jruby-9.0.5.0
+  - 2.6
+  - jruby-9.2.7.0
 notifications:
   email:
@@ -17,15 +16,13 @@ sudo: false
 env:
   global:
     # If changing this number, please also change it in `test/test_helper.rb`.
-    - STRIPE_MOCK_VERSION=0.44.0
+    - STRIPE_MOCK_VERSION=0.63.0
 cache:
   directories:
     - stripe-mock
 before_install:
-  # Install bundler 1.x, because we need to support Ruby 2.1 for now
-  - gem install bundler -v "~> 1.0"
   # Unpack and start stripe-mock so that the test suite can talk to it
   - |
     if [ ! -d "stripe-mock/stripe-mock_${STRIPE_MOCK_VERSION}" ]; then

data/.vscode/extensions.json ADDED

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "rebornix.ruby",
+    "misogi.ruby-rubocop",
+    "EditorConfig.editorconfig"
+  ]
+}

data/.vscode/settings.json ADDED

@@ -0,0 +1,8 @@
+{
+  "editor.formatOnSave": true,
+  "files.trimTrailingWhitespace": true,
+  // Rubocop settings
+  "ruby.rubocop.configFilePath": ".rubocop.yml",
+  "ruby.rubocop.onSave": true
+}

data/CHANGELOG.md CHANGED

@@ -1,5 +1,104 @@
 # Changelog
+## 5.1.0 - 2019-08-27
+* [#841](https://github.com/stripe/stripe-ruby/pull/841) Retry requests on a 429 that's a lock timeout
+## 5.0.1 - 2019-08-20
+* [#836](https://github.com/stripe/stripe-ruby/pull/836) Increase connection keep alive timeout to 30 seconds
+## 5.0.0 - 2019-08-20
+Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v5) contains a detailed list of backwards-incompatible changes with upgrade instructions.
+Pull requests included in this release (cf. [#815](https://github.com/stripe/stripe-ruby/pull/815)) (⚠️ = breaking changes):
+* [x] ⚠️ #813: Convert library to use built-in `Net::HTTP`
+* [x] ⚠️ #816: Make `code` argument in `CardError` named instead of positional.
+* [x] ⚠️ #817: Drop support for very old Ruby versions.
+* [x] #818: Bump Rubocop to latest version
+* [x] #819: Ruby minimum version increase followup
+* [x] ⚠️ #820: Remove old deprecated methods
+* [x] ⚠️ #823: Remove all alias for list methods
+* [x] ⚠️ #826: Remove `UsageRecord.create` method
+* [x] ⚠️ #827: Remove `IssuerFraudRecord`
+* [x] #811: Add `ErrorObject` to `StripeError` exceptions
+* [x] #828: Tweak retry logic to be a little more like stripe-node
+* [x] #829: Reset connections when connection-changing configuration changes (optional)
+* [x] #830: Fix inverted sign for 500 retries
+* [x] ⚠️#831: Remove a few more very old deprecated methods
+* [x] #832: Minor cleanup in `StripeClient`
+* [x] #833: Do better bookkeeping when tracking state in `Thread.current`
+* [x] #834: Add `Invoice.list_upcoming_line_items` method
+## 4.24.0 - 2019-08-12
+* [#825](https://github.com/stripe/stripe-ruby/pull/825) Add `SubscriptionItem.create_usage_record` method
+  - This release also removed the `SubscriptionSchedule.revisions` method. This should have been included in the previous release (4.23.0)
+## 4.23.0 - 2019-08-09
+* [#824](https://github.com/stripe/stripe-ruby/pull/824) Remove SubscriptionScheduleRevision
+  - This is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
+## 4.22.1 - 2019-08-09
+* [#808](https://github.com/stripe/stripe-ruby/pull/808) Unify request/response handling
+## 4.22.0 - 2019-07-30
+* [#821](https://github.com/stripe/stripe-ruby/pull/821) Listing `BalanceTransaction` objects now uses `/v1/balance_transactions` instead of `/v1/balance/history`
+## 4.21.3 - 2019-07-15
+* [#810](https://github.com/stripe/stripe-ruby/pull/810) Better error message when passing non-string to custom method
+## 4.21.2 - 2019-07-05
+* [#806](https://github.com/stripe/stripe-ruby/pull/806) Revert back to `initialize_from` from `Util.convert_to_stripe_object`
+## 4.21.1 - 2019-07-04
+* [#807](https://github.com/stripe/stripe-ruby/pull/807) Add gem metadata
+## 4.21.0 - 2019-06-28
+* [#803](https://github.com/stripe/stripe-ruby/pull/803) Add support for the `SetupIntent` resource and APIs
+## 4.20.1 - 2019-06-28
+* [#805](https://github.com/stripe/stripe-ruby/pull/805) Fix formatting in `ConnectionFailed` error message
+## 4.20.0 - 2019-06-24
+* [#800](https://github.com/stripe/stripe-ruby/pull/800) Enable request latency telemetry by default
+## 4.19.0 - 2019-06-17
+* [#770](https://github.com/stripe/stripe-ruby/pull/770) Add support for `CustomerBalanceTransaction` resource and APIs
+## 4.18.1 - 2019-05-27
+* [#789](https://github.com/stripe/stripe-ruby/pull/789) Allow `Order#pay` to be called without arguments
+## 4.18.0 - 2019-05-23
+* [#783](https://github.com/stripe/stripe-ruby/pull/783) Add support for `radar.early_fraud_warning` resource
+## 4.17.0 - 2019-05-14
+* [#779](https://github.com/stripe/stripe-ruby/pull/779) Add support for the Capability resource and APIs
+## 4.16.0 - 2019-04-24
+* [#760](https://github.com/stripe/stripe-ruby/pull/760) Add support for the `TaxRate` resource and APIs
+## 4.15.0 - 2019-04-22
+* [#762](https://github.com/stripe/stripe-ruby/pull/762) Add support for the `TaxId` resource and APIs
+## 4.14.0 - 2019-04-18
+* [#758](https://github.com/stripe/stripe-ruby/pull/758) Add support for the `CreditNote` resource and APIs
+## 4.13.0 - 2019-04-16
+* [#766](https://github.com/stripe/stripe-ruby/pull/766) Relax constraints on objects that we'll accept as a file (now they just need to respond to `#read`)
+## 4.12.0 - 2019-04-02
+* [#752](https://github.com/stripe/stripe-ruby/pull/752) Add `.delete` class method on deletable API resources
+* [#754](https://github.com/stripe/stripe-ruby/pull/754) Add class methods for all custom API requests (e.g. `Charge.capture`)
+## 4.11.0 - 2019-03-26
+* [#753](https://github.com/stripe/stripe-ruby/pull/753) Add a global proxy configuration parameter
+## 4.10.0 - 2019-03-18
+* [#745](https://github.com/stripe/stripe-ruby/pull/745) Add support for the `PaymentMethod` resource and APIs
+* [#747](https://github.com/stripe/stripe-ruby/pull/747) Add support for retrieving a Checkout `Session`
+* [#748](https://github.com/stripe/stripe-ruby/pull/748) Add support for deleting a Terminal `Location` and `Reader`
+## 4.9.1 - 2019-03-18
+* [#750](https://github.com/stripe/stripe-ruby/pull/750) Catch error and warn if unable to remove a method
 ## 4.9.0 - 2019-02-12
 * [#739](https://github.com/stripe/stripe-ruby/pull/739) Add support for `SubscriptionSchedule` and `SubscriptionScheduleRevision`
@@ -25,7 +124,7 @@
 * [#718](https://github.com/stripe/stripe-ruby/pull/718) Fix an error message typo
 ## 4.4.0 - 2018-12-21
-* [#716](https://github.com/stripe/stripe-ruby/pull/716) Add support for the `CheckoutSession` resource
+* [#716](https://github.com/stripe/stripe-ruby/pull/716) Add support for the `CheckoutSession` resource
 ## 4.3.0 - 2018-12-10
 * [#711](https://github.com/stripe/stripe-ruby/pull/711) Add support for account links
@@ -208,7 +307,8 @@
 * Handle `invalid_client` OAuth error code
 * Improve safety of error handling logic safer for unrecognized OAuth error codes
-## 3.0.2 - 2017-07-12 (yanked)
+## 3.0.2 - 2017-07-12
+**Important:** This version is non-functional and has been yanked in favor of 3.0.3.
 * Convert `nil` to empty string when serializing parameters (instead of opaquely dropping it) -- NOTE: this change has since been reverted
 ## 3.0.1 - 2017-07-11

data/Gemfile CHANGED

@@ -7,6 +7,7 @@ gemspec
 group :development do
   gem "coveralls", require: false
   gem "mocha", "~> 0.13.2"
+  gem "rack", ">= 2.0.6"
   gem "rake"
   gem "shoulda-context"
   gem "test-unit"
@@ -18,16 +19,7 @@ group :development do
   # `Gemfile.lock` checked in, so to prevent good builds from suddenly going
   # bad, pin to a specific version number here. Try to keep this relatively
   # up-to-date, but it's not the end of the world if it's not.
-  gem "rubocop", "0.50.0"
-  # Rack 2.0+ requires Ruby >= 2.2.2 which is problematic for the test suite on
-  # older Ruby versions. Check Ruby the version here and put a maximum
-  # constraint on Rack if necessary.
-  if RUBY_VERSION >= "2.2.2"
-    gem "rack", ">= 2.0.6"
-  else
-    gem "rack", ">= 1.6.11", "< 2.0" # rubocop:disable Bundler/DuplicatedGem
-  end
+  gem "rubocop", "0.73"
   platforms :mri do
     gem "byebug"

data/README.md CHANGED

@@ -11,11 +11,11 @@ API.
 The library also provides other features. For example:
-* Easy configuration path for fast setup and use.
-* Helpers for pagination.
-* Tracking of "fresh" values in API resources so that partial updates can be
+- Easy configuration path for fast setup and use.
+- Helpers for pagination.
+- Tracking of "fresh" values in API resources so that partial updates can be
   executed.
-* Built-in mechanisms for the serialization of parameters according to the
+- Built-in mechanisms for the serialization of parameters according to the
   expectations of Stripe's API.
 ## Documentation
@@ -27,15 +27,19 @@ See the [Ruby API docs](https://stripe.com/docs/api/ruby#intro).
 You don't need this source code unless you want to modify the gem. If you just
 want to use the package, just run:
-    gem install stripe
+```sh
+gem install stripe
+```
 If you want to build the gem from source:
-    gem build stripe.gemspec
+```sh
+gem build stripe.gemspec
+```
 ### Requirements
-* Ruby 2.0+.
+- Ruby 2.3+.
 ### Bundler
@@ -43,7 +47,7 @@ If you are installing via bundler, you should be sure to use the https rubygems
 source in your Gemfile, as any gems fetched over http could potentially be
 compromised in transit and alter the code of gems fetched securely over https:
-``` ruby
+```ruby
 source 'https://rubygems.org'
 gem 'rails'
@@ -56,7 +60,7 @@ The library needs to be configured with your account's secret key which is
 available in your [Stripe Dashboard][api-keys]. Set `Stripe.api_key` to its
 value:
-``` ruby
+```ruby
 require "stripe"
 Stripe.api_key = "sk_test_..."
@@ -75,37 +79,46 @@ For apps that need to use multiple keys during the lifetime of a process, like
 one that uses [Stripe Connect][connect], it's also possible to set a
 per-request key and/or account:
-``` ruby
+```ruby
 require "stripe"
 Stripe::Charge.list(
   {},
   {
-    :api_key => "sk_test_...",
-    :stripe_account => "acct_...",
-    :stripe_version => "2018-02-28"
+    api_key: "sk_test_...",
+    stripe_account: "acct_...",
+    stripe_version: "2018-02-28",
   }
 )
 Stripe::Charge.retrieve(
   "ch_18atAXCdGbJFKhCuBAa4532Z",
   {
-    :api_key => "sk_test_...",
-    :stripe_account => "acct_...",
-    :stripe_version => "2018-02-28"
+    api_key: "sk_test_...",
+    stripe_account: "acct_...",
+    stripe_version: "2018-02-28",
+  }
+)
+Stripe::Charge.retrieve(
+  {
+    id: "ch_18atAXCdGbJFKhCuBAa4532Z",
+    expand: %w(balance_transaction)
+  },
+  {
+    stripe_version: "2018-02-28",
+    api_key: "sk_test_...",
   }
 )
 ```
-### Configuring a Client
+### Accessing a response object
-While a default HTTP client is used by default, it's also possible to have the
-library use any client supported by [Faraday][faraday] by initializing a
-`Stripe::StripeClient` object and giving it a connection:
+Get access to response objects by initializing a client and using its `request`
+method:
-``` ruby
-conn = Faraday.new
-client = Stripe::StripeClient.new(conn)
+```ruby
+client = Stripe::StripeClient.new
 charge, resp = client.request do
   Stripe::Charge.retrieve(
     "ch_18atAXCdGbJFKhCuBAa4532Z",
@@ -114,12 +127,22 @@ end
 puts resp.request_id
 ```
+### Configuring a proxy
+A proxy can be configured with `Stripe.proxy`:
+```ruby
+Stripe.proxy = "https://user:pass@example.com:1234"
+```
 ### Configuring an API Version
 By default, the library will use the API version pinned to the account making
 a request. This can be overridden with this global option:
-    Stripe.api_version = "2018-02-28"
+```ruby
+Stripe.api_version = "2018-02-28"
+```
 See [versioning in the API reference][versioning] for more information.
@@ -128,14 +151,21 @@ See [versioning in the API reference][versioning] for more information.
 By default, the library will use its own internal bundle of known CA
 certificates, but it's possible to configure your own:
-    Stripe.ca_bundle_path = "path/to/ca/bundle"
+```ruby
+Stripe.ca_bundle_path = "path/to/ca/bundle"
+```
 ### Configuring Automatic Retries
-The library can be configured to automatically retry requests that fail due to
-an intermittent network problem:
+You can enable automatic retries on requests that fail due to a transient
+problem by configuring the maximum number of retries:
+```ruby
+Stripe.max_network_retries = 2
+```
-    Stripe.max_network_retries = 2
+Various errors can trigger a retry, like a connection error or a timeout, and
+also certain API responses like HTTP status `409 Conflict`.
 [Idempotency keys][idempotency-keys] are added to requests to guarantee that
 retries are safe.
@@ -144,7 +174,7 @@ retries are safe.
 Open and read timeouts are configurable:
-```java
+```ruby
 Stripe.open_timeout = 30 // in seconds
 Stripe.read_timeout = 80
 ```
@@ -162,12 +192,14 @@ production use, but `debug` is also available for more verbosity.
 There are a few options for enabling it:
 1. Set the environment variable `STRIPE_LOG` to the value `debug` or `info`:
-   ```
+   ```sh
    $ export STRIPE_LOG=info
    ```
 2. Set `Stripe.log_level`:
-   ``` ruby
+   ```ruby
    Stripe.log_level = Stripe::LEVEL_INFO
    ```
@@ -176,39 +208,64 @@ There are a few options for enabling it:
 If you're writing a plugin that uses the library, we'd appreciate it if you
 identified using `#set_app_info`:
-    Stripe.set_app_info("MyAwesomePlugin", version: "1.2.34", url: "https://myawesomeplugin.info");
+```ruby
+Stripe.set_app_info("MyAwesomePlugin", version: "1.2.34", url: "https://myawesomeplugin.info");
+```
 This information is passed along when the library makes calls to the Stripe
 API.
+### Request latency telemetry
+By default, the library sends request latency telemetry to Stripe. These
+numbers help Stripe improve the overall latency of its API for all users.
+You can disable this behavior if you prefer:
+```ruby
+Stripe.enable_telemetry = false
+```
 ## Development
 The test suite depends on [stripe-mock], so make sure to fetch and run it from a
 background terminal ([stripe-mock's README][stripe-mock] also contains
 instructions for installing via Homebrew and other methods):
-    go get -u github.com/stripe/stripe-mock
-    stripe-mock
+```sh
+go get -u github.com/stripe/stripe-mock
+stripe-mock
+```
 Run all tests:
-    bundle exec rake test
+```sh
+bundle exec rake test
+```
 Run a single test suite:
-    bundle exec ruby -Ilib/ test/stripe/util_test.rb
+```sh
+bundle exec ruby -Ilib/ test/stripe/util_test.rb
+```
 Run a single test:
-    bundle exec ruby -Ilib/ test/stripe/util_test.rb -n /should.convert.names.to.symbols/
+```sh
+bundle exec ruby -Ilib/ test/stripe/util_test.rb -n /should.convert.names.to.symbols/
+```
 Run the linter:
-    bundle exec rake rubocop
+```sh
+bundle exec rake rubocop
+```
 Update bundled CA certificates from the [Mozilla cURL release][curl]:
-    bundle exec rake update_certs
+```sh
+bundle exec rake update_certs
+```
 Update the bundled [stripe-mock] by editing the version number found in
 `.travis.yml`.
@@ -216,7 +273,6 @@ Update the bundled [stripe-mock] by editing the version number found in
 [api-keys]: https://dashboard.stripe.com/account/apikeys
 [connect]: https://stripe.com/connect
 [curl]: http://curl.haxx.se/docs/caextract.html
-[faraday]: https://github.com/lostisland/faraday
 [idempotency-keys]: https://stripe.com/docs/api/ruby#idempotent_requests
 [stripe-mock]: https://github.com/stripe/stripe-mock
 [versioning]: https://stripe.com/docs/api/ruby#versioning