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

stripe 4.9.0 → 5.28.0

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