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

stripe 4.9.0 → 5.28.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 (251) hide show

checksums.yaml +4 -4
data/.editorconfig +10 -0
data/.rubocop.yml +56 -8
data/.rubocop_todo.yml +8 -25
data/.travis.yml +4 -8
data/.vscode/extensions.json +7 -0
data/.vscode/settings.json +8 -0
data/CHANGELOG.md +206 -2
data/CODE_OF_CONDUCT.md +77 -0
data/Gemfile +10 -13
data/README.md +178 -58
data/Rakefile +8 -7
data/VERSION +1 -1
data/lib/stripe.rb +41 -195
data/lib/stripe/api_operations/create.rb +1 -1
data/lib/stripe/api_operations/delete.rb +28 -2
data/lib/stripe/api_operations/list.rb +1 -12
data/lib/stripe/api_operations/nested_resource.rb +38 -28
data/lib/stripe/api_operations/request.rb +47 -8
data/lib/stripe/api_operations/save.rb +8 -7
data/lib/stripe/api_resource.rb +52 -3
data/lib/stripe/connection_manager.rb +162 -0
data/lib/stripe/error_object.rb +94 -0
data/lib/stripe/errors.rb +31 -10
data/lib/stripe/instrumentation.rb +82 -0
data/lib/stripe/list_object.rb +41 -7
data/lib/stripe/multipart_encoder.rb +131 -0
data/lib/stripe/oauth.rb +4 -3
data/lib/stripe/object_types.rb +101 -0
data/lib/stripe/resources.rb +84 -0
data/lib/stripe/{account.rb → resources/account.rb} +50 -27
data/lib/stripe/{account_link.rb → resources/account_link.rb} +2 -1
data/lib/stripe/resources/alipay_account.rb +34 -0
data/lib/stripe/{apple_pay_domain.rb → resources/apple_pay_domain.rb} +2 -1
data/lib/stripe/resources/application_fee.rb +14 -0
data/lib/stripe/resources/application_fee_refund.rb +30 -0
data/lib/stripe/{balance.rb → resources/balance.rb} +2 -1
data/lib/stripe/{balance_transaction.rb → resources/balance_transaction.rb} +2 -5
data/lib/stripe/resources/bank_account.rb +43 -0
data/lib/stripe/resources/billing_portal/session.rb +12 -0
data/lib/stripe/{bitcoin_receiver.rb → resources/bitcoin_receiver.rb} +4 -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} +13 -4
data/lib/stripe/resources/charge.rb +23 -0
data/lib/stripe/resources/checkout/session.rb +16 -0
data/lib/stripe/{country_spec.rb → resources/country_spec.rb} +2 -1
data/lib/stripe/{coupon.rb → resources/coupon.rb} +3 -2
data/lib/stripe/resources/credit_note.rb +33 -0
data/lib/stripe/resources/credit_note_line_item.rb +7 -0
data/lib/stripe/resources/customer.rb +36 -0
data/lib/stripe/resources/customer_balance_transaction.rb +30 -0
data/lib/stripe/resources/discount.rb +7 -0
data/lib/stripe/resources/dispute.rb +22 -0
data/lib/stripe/{ephemeral_key.rb → resources/ephemeral_key.rb} +6 -2
data/lib/stripe/{event.rb → resources/event.rb} +2 -1
data/lib/stripe/{exchange_rate.rb → resources/exchange_rate.rb} +2 -1
data/lib/stripe/{file.rb → resources/file.rb} +9 -11
data/lib/stripe/{file_link.rb → resources/file_link.rb} +3 -2
data/lib/stripe/resources/invoice.rb +74 -0
data/lib/stripe/{invoice_item.rb → resources/invoice_item.rb} +3 -2
data/lib/stripe/{invoice_line_item.rb → resources/invoice_line_item.rb} +1 -1
data/lib/stripe/resources/issuing/authorization.rb +34 -0
data/lib/stripe/resources/issuing/card.rb +25 -0
data/lib/stripe/{issuing → resources/issuing}/card_details.rb +1 -1
data/lib/stripe/{issuing → resources/issuing}/cardholder.rb +3 -2
data/lib/stripe/resources/issuing/dispute.rb +25 -0
data/lib/stripe/{issuing → resources/issuing}/transaction.rb +3 -2
data/lib/stripe/resources/line_item.rb +7 -0
data/lib/stripe/resources/login_link.rb +14 -0
data/lib/stripe/resources/mandate.rb +8 -0
data/lib/stripe/resources/order.rb +33 -0
data/lib/stripe/{order_return.rb → resources/order_return.rb} +2 -1
data/lib/stripe/resources/payment_intent.rb +43 -0
data/lib/stripe/resources/payment_method.rb +33 -0
data/lib/stripe/resources/payout.rb +33 -0
data/lib/stripe/{person.rb → resources/person.rb} +8 -3
data/lib/stripe/{plan.rb → resources/plan.rb} +2 -1
data/lib/stripe/resources/price.rb +12 -0
data/lib/stripe/{product.rb → resources/product.rb} +4 -3
data/lib/stripe/resources/promotion_code.rb +12 -0
data/lib/stripe/resources/radar/early_fraud_warning.rb +12 -0
data/lib/stripe/{radar → resources/radar}/value_list.rb +3 -2
data/lib/stripe/{radar → resources/radar}/value_list_item.rb +3 -2
data/lib/stripe/{recipient.rb → resources/recipient.rb} +3 -6
data/lib/stripe/{recipient_transfer.rb → resources/recipient_transfer.rb} +1 -1
data/lib/stripe/{refund.rb → resources/refund.rb} +2 -1
data/lib/stripe/{reporting → resources/reporting}/report_run.rb +3 -2
data/lib/stripe/{reporting → resources/reporting}/report_type.rb +3 -2
data/lib/stripe/resources/reversal.rb +29 -0
data/lib/stripe/resources/review.rb +21 -0
data/lib/stripe/resources/setup_attempt.rb +10 -0
data/lib/stripe/resources/setup_intent.rb +33 -0
data/lib/stripe/{sigma → resources/sigma}/scheduled_query_run.rb +3 -2
data/lib/stripe/{sku.rb → resources/sku.rb} +4 -3
data/lib/stripe/resources/source.rb +47 -0
data/lib/stripe/{source_transaction.rb → resources/source_transaction.rb} +1 -1
data/lib/stripe/resources/subscription.rb +26 -0
data/lib/stripe/resources/subscription_item.rb +26 -0
data/lib/stripe/resources/subscription_schedule.rb +33 -0
data/lib/stripe/resources/tax_id.rb +26 -0
data/lib/stripe/resources/tax_rate.rb +12 -0
data/lib/stripe/resources/terminal/connection_token.rb +12 -0
data/lib/stripe/{terminal → resources/terminal}/location.rb +4 -2
data/lib/stripe/{terminal → resources/terminal}/reader.rb +4 -2
data/lib/stripe/{three_d_secure.rb → resources/three_d_secure.rb} +2 -1
data/lib/stripe/{token.rb → resources/token.rb} +2 -1
data/lib/stripe/resources/topup.rb +23 -0
data/lib/stripe/resources/transfer.rb +27 -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} +3 -2
data/lib/stripe/singleton_api_resource.rb +3 -1
data/lib/stripe/stripe_client.rb +493 -236
data/lib/stripe/stripe_configuration.rb +178 -0
data/lib/stripe/stripe_object.rb +75 -61
data/lib/stripe/stripe_response.rb +53 -21
data/lib/stripe/util.rb +66 -109
data/lib/stripe/version.rb +1 -1
data/lib/stripe/webhook.rb +43 -10
data/stripe.gemspec +14 -5
data/test/stripe/account_link_test.rb +4 -4
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 +159 -37
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/billing_portal/session_test.rb +18 -0
data/test/stripe/capability_test.rb +45 -0
data/test/stripe/charge_test.rb +13 -8
data/test/stripe/checkout/session_test.rb +19 -1
data/test/stripe/connection_manager_test.rb +167 -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 +90 -0
data/test/stripe/customer_balance_transaction_test.rb +37 -0
data/test/stripe/customer_card_test.rb +7 -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 +42 -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/instrumentation_test.rb +74 -0
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 +27 -6
data/test/stripe/issuing/cardholder_test.rb +1 -1
data/test/stripe/issuing/dispute_test.rb +23 -14
data/test/stripe/issuing/transaction_test.rb +1 -1
data/test/stripe/list_object_test.rb +70 -24
data/test/stripe/login_link_test.rb +2 -2
data/test/stripe/mandate_test.rb +14 -0
data/test/stripe/multipart_encoder_test.rb +130 -0
data/test/stripe/oauth_test.rb +17 -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 +23 -1
data/test/stripe/person_test.rb +1 -1
data/test/stripe/plan_test.rb +26 -20
data/test/stripe/price_test.rb +48 -0
data/test/stripe/product_test.rb +17 -8
data/test/stripe/promotion_code_test.rb +42 -0
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_attempt_test.rb +16 -0
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 +52 -19
data/test/stripe/stripe_client_test.rb +546 -78
data/test/stripe/stripe_configuration_test.rb +131 -0
data/test/stripe/stripe_object_test.rb +16 -41
data/test/stripe/stripe_response_test.rb +71 -25
data/test/stripe/subscription_item_test.rb +38 -7
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 +15 -5
data/test/stripe/util_test.rb +1 -1
data/test/stripe/webhook_endpoint_test.rb +18 -1
data/test/stripe/webhook_test.rb +48 -9
data/test/stripe_mock.rb +4 -3
data/test/stripe_test.rb +102 -33
data/test/test_helper.rb +16 -12
metadata +141 -129
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/bank_account.rb +0 -32
data/lib/stripe/charge.rb +0 -84
data/lib/stripe/checkout/session.rb +0 -11
data/lib/stripe/customer.rb +0 -90
data/lib/stripe/dispute.rb +0 -19
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/issuing/dispute.rb +0 -13
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/source.rb +0 -38
data/lib/stripe/subscription.rb +0 -25
data/lib/stripe/subscription_item.rb +0 -17
data/lib/stripe/subscription_schedule.rb +0 -32
data/lib/stripe/subscription_schedule_revision.rb +0 -25
data/lib/stripe/terminal/connection_token.rb +0 -11
data/lib/stripe/topup.rb +0 -16
data/lib/stripe/transfer.rb +0 -23
data/lib/stripe/usage_record.rb +0 -14
data/test/api_stub_helpers.rb +0 -1
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/source_transaction_test.rb +0 -19
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: fc768f1967f8b5d8d925a101dffc820bd4dfa96155cecc9bd86926cb30f07cbe
+  data.tar.gz: 7dcd29fb83035f6f6af335bf3a4acde40ea4ce7e0e097413b9f76c696bb3e529
 SHA512:
-  metadata.gz: 9c19e6198d482addce7c6a9fd6e469a6c362139ada4926901c3e0d1704283de1b746c94c13ecee944741b8a7ad60f9acd0830bda020a3516b2a485f8e260c2ee
-  data.tar.gz: 545bd13709cb412e3c6505756eb566566d1658667c19572339811c6fd70d3425ecd0999a4d07fb1dd24bdebd5f4f4739bdf15e5a3286e058fbca1f06da884f7e
+  metadata.gz: e911a5c3138805c0aeb5abe270186e4d4219b8414e3336579cda3caa02ad32797d0d088cce8468156f4dff27a6ff55ac107419e7a0b01040eec36be8684073d7
+  data.tar.gz: 6fd38cd5ffde35f1065ce18104382f106eec79fb3494099e49723745ada158f7f63df1164653a6ada3fe0c62ae0ed764cbf9e40e878f4e3bb4dbd6c799cffbfa

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,31 +2,79 @@ inherit_from: .rubocop_todo.yml
 AllCops:
   DisplayCopNames: true
-  TargetRubyVersion: 2.0
+  TargetRubyVersion: 2.3
+  Exclude:
+    # brandur: Exclude ephmeral script-like files that I use to try and
+    # reproduce problems with the library. If you know of a better way of doing
+    # this (e.g. exclude files not tracked by Git), feel free to change it.
+    - "example_*"
 Layout/CaseIndentation:
   EnforcedStyle: end
-Layout/IndentArray:
+Layout/FirstArrayElementIndentation:
   EnforcedStyle: consistent
-Layout/IndentHash:
+Layout/FirstHashElementIndentation:
   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/HeredocIndentation:
+  Enabled: false
+Layout/LineLength:
+  Exclude:
+    - "lib/stripe/resources/**/*.rb"
+    - "test/**/*.rb"
+Metrics/BlockLength:
+  Max: 40
+  Exclude:
+    # `context` in tests are blocks and get quite large, so exclude the test
+    # directory from having to adhere to this rule.
+    - "test/**/*.rb"
+Metrics/ClassLength:
+  Exclude:
+    # Test classes get quite large, so exclude the test directory from having
+    # to adhere to this rule.
+    - "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
-  # probably too short).
-  Max: 50
+  # There's ~2 long methods in `StripeClient` and one in `NestedResource`. If
+  # we want to truncate those a little, we could move this to be closer to ~30
+  # (but the default of 10 is probably too short).
+  Max: 55
 Metrics/ModuleLength:
   Enabled: false
+Style/AccessModifierDeclarations:
+  EnforcedStyle: inline
 Style/FrozenStringLiteralComment:
   EnforcedStyle: always
+Style/HashEachMethods:
+  Enabled: true
+Style/HashTransformKeys:
+  Enabled: true
+Style/HashTransformValues:
+  Enabled: true
+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,33 @@
 # 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
-# Configuration parameters: CountComments, ExcludedMethods.
-Metrics/BlockLength:
-  Max: 498
-# 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,31 +1,27 @@
 language: ruby
 rvm:
-  - 2.1
-  - 2.2
   - 2.3
   - 2.4
   - 2.5
-  - jruby-9.0.5.0
+  - 2.6
+  - 2.7
+  - jruby-9.2.7.0
 notifications:
   email:
     on_success: never
-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.101.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,208 @@
 # Changelog
+## 5.28.0 - 2020-10-14
+* [#950](https://github.com/stripe/stripe-ruby/pull/950) Add configuration option for `write_timeout` for connections on Ruby 2.6+
+## 5.27.0 - 2020-10-14
+* [#951](https://github.com/stripe/stripe-ruby/pull/951) Add support for the Payout Reverse API
+## 5.26.0 - 2020-09-29
+* [#949](https://github.com/stripe/stripe-ruby/pull/949) Add support for the `SetupAttempt` resource and List API
+## 5.25.0 - 2020-09-02
+* [#944](https://github.com/stripe/stripe-ruby/pull/944) Add support for the Issuing Dispute Submit API
+## 5.24.0 - 2020-08-26
+* [#939](https://github.com/stripe/stripe-ruby/pull/939) Extract configurations into separate object
+* [#940](https://github.com/stripe/stripe-ruby/pull/940) Fix typo in documentation of `stripe_object.rb`
+## 5.23.1 - 2020-08-05
+* [#936](https://github.com/stripe/stripe-ruby/pull/936) Rename API resource's `request` method
+## 5.23.0 - 2020-08-05
+* [#937](https://github.com/stripe/stripe-ruby/pull/937) Add support for the `PromotionCode` resource and APIs
+## 5.22.0 - 2020-05-11
+* [#918](https://github.com/stripe/stripe-ruby/pull/918) Add support for the `LineItem` resource and APIs
+## 5.21.0 - 2020-04-29
+* [#917](https://github.com/stripe/stripe-ruby/pull/917) Add support for the `Price` resource and APIs
+## 5.20.0 - 2020-04-27
+* [#916](https://github.com/stripe/stripe-ruby/pull/916) Add new `.generate_header` method for webhooks
+## 5.19.0 - 2020-04-24
+* [#915](https://github.com/stripe/stripe-ruby/pull/915) Expose `Stripe::Webhook.compute_signature` publicly
+## 5.18.0 - 2020-04-22
+* [#911](https://github.com/stripe/stripe-ruby/pull/911) Add support for `BillingPortal` namespace and `Session` resource and APIs
+## 5.17.0 - 2020-02-26
+* [#907](https://github.com/stripe/stripe-ruby/pull/907) Add `StripeError#idempotent_replayed?`
+## 5.16.0 - 2020-02-26
+* [#906](https://github.com/stripe/stripe-ruby/pull/906) Add support for listing Checkout sessions
+* [#903](https://github.com/stripe/stripe-ruby/pull/903) Upgrade to Rubocop 0.80
+## 5.15.0 - 2020-02-10
+* [#902](https://github.com/stripe/stripe-ruby/pull/902) Add `request_begin` instrumentation callback
+## 5.14.0 - 2020-01-14
+* [#896](https://github.com/stripe/stripe-ruby/pull/896) Add support for `CreditNoteLineItem`
+* [#894](https://github.com/stripe/stripe-ruby/pull/894) Clean up test output by capturing `$stderr` when we expect warnings
+* [#892](https://github.com/stripe/stripe-ruby/pull/892) Explicitly pass a parameter as hash to be more ruby 2.7 friendly
+* [#893](https://github.com/stripe/stripe-ruby/pull/893) Upgrade Rubocop to 0.79
+## 5.13.0 - 2020-01-08
+* [#891](https://github.com/stripe/stripe-ruby/pull/891) Fix most Ruby 2.7 warnings
+## 5.12.1 - 2020-01-06
+* [#890](https://github.com/stripe/stripe-ruby/pull/890) Override API key with `client_secret` in `OAuth.token`
+## 5.12.0 - 2020-01-02
+* [#889](https://github.com/stripe/stripe-ruby/pull/889) Add support for retrieve source transaction API method
+## 5.11.0 - 2019-11-26
+* [#885](https://github.com/stripe/stripe-ruby/pull/885) Add support for `CreditNote` preview
+## 5.10.0 - 2019-11-08
+* [#882](https://github.com/stripe/stripe-ruby/pull/882) Add list_usage_record_summaries and list_source_transactions
+## 5.9.0 - 2019-11-07
+* [#870](https://github.com/stripe/stripe-ruby/pull/870) Add request instrumentation callback (see `README.md` for usage example)
+## 5.8.0 - 2019-11-05
+* [#879](https://github.com/stripe/stripe-ruby/pull/879) Add support for `Mandate`
+* [#876](https://github.com/stripe/stripe-ruby/pull/876) Add additional per-request configuration documentation
+* [#874](https://github.com/stripe/stripe-ruby/pull/874) Raise an error when requests params are invalid
+* [#873](https://github.com/stripe/stripe-ruby/pull/873) Contributor Covenant
+## 5.7.1 - 2019-10-15
+* [#869](https://github.com/stripe/stripe-ruby/pull/869) Fixes the misnamed `connection_base=` setter to be named `connect_base=`
+## 5.7.0 - 2019-10-10
+* [#865](https://github.com/stripe/stripe-ruby/pull/865) Support backwards pagination with list's `#auto_paging_each`
+## 5.6.0 - 2019-10-04
+* [#861](https://github.com/stripe/stripe-ruby/pull/861) Nicer error when specifying non-nil non-string opt value
+## 5.5.0 - 2019-10-03
+* [#859](https://github.com/stripe/stripe-ruby/pull/859) User-friendly messages and retries for `EOFError`, `Errno::ECONNRESET`, `Errno::ETIMEDOUT`, and `Errno::EHOSTUNREACH` network errors
+## 5.4.1 - 2019-10-01
+* [#858](https://github.com/stripe/stripe-ruby/pull/858) Drop Timecop dependency
+## 5.4.0 - 2019-10-01
+* [#857](https://github.com/stripe/stripe-ruby/pull/857) Move to monotonic time for duration calculations
+## 5.3.0 - 2019-10-01
+* [#853](https://github.com/stripe/stripe-ruby/pull/853) Support `Stripe-Should-Retry` header
+## 5.2.0 - 2019-09-19
+* [#851](https://github.com/stripe/stripe-ruby/pull/851) Introduce system for garbage collecting connection managers
+## 5.1.1 - 2019-09-04
+* [#845](https://github.com/stripe/stripe-ruby/pull/845) Transfer the request_id from the http_headers to error.
+## 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):
+* ⚠️ [#813](https://github.com/stripe/stripe-ruby/pull/813): Convert library to use built-in `Net::HTTP`
+* ⚠️ [#816](https://github.com/stripe/stripe-ruby/pull/816): Make `code` argument in `CardError` named instead of positional.
+* ⚠️ [#817](https://github.com/stripe/stripe-ruby/pull/817): Drop support for very old Ruby versions.
+* [#818](https://github.com/stripe/stripe-ruby/pull/818): Bump Rubocop to latest version
+* [#819](https://github.com/stripe/stripe-ruby/pull/819): Ruby minimum version increase followup
+* ⚠️ [#820](https://github.com/stripe/stripe-ruby/pull/820): Remove old deprecated methods
+* ⚠️ [#823](https://github.com/stripe/stripe-ruby/pull/823): Remove all alias for list methods
+* ⚠️ [#826](https://github.com/stripe/stripe-ruby/pull/826): Remove `UsageRecord.create` method
+* ⚠️ [#827](https://github.com/stripe/stripe-ruby/pull/827): Remove `IssuerFraudRecord`
+* [#811](https://github.com/stripe/stripe-ruby/pull/811): Add `ErrorObject` to `StripeError` exceptions
+* [#828](https://github.com/stripe/stripe-ruby/pull/828): Tweak retry logic to be a little more like stripe-node
+* [#829](https://github.com/stripe/stripe-ruby/pull/829): Reset connections when connection-changing configuration changes (optional)
+* [#830](https://github.com/stripe/stripe-ruby/pull/830): Fix inverted sign for 500 retries
+* ⚠️[#831](https://github.com/stripe/stripe-ruby/pull/831): Remove a few more very old deprecated methods
+* [#832](https://github.com/stripe/stripe-ruby/pull/832): Minor cleanup in `StripeClient`
+* [#833](https://github.com/stripe/stripe-ruby/pull/833): Do better bookkeeping when tracking state in `Thread.current`
+* [#834](https://github.com/stripe/stripe-ruby/pull/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 +228,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 +411,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