117 KiB
		
	
	
	
	
	
	
	
			
		
		
	
	Changelog
15.2.0-beta.1 - 2025-04-30
- 
#1589 Update generated code for beta This release changes the pinned API version to
2025-04-30.preview.- Add support for 
billing_modeonCheckout::Session::CreateParams::SubscriptionDatum,Invoice::CreatePreviewParams::ScheduleDetail,Invoice::CreatePreviewParams::SubscriptionDetail,Quote::CreateParams::SubscriptionDatum,Quote::SubscriptionDatum,QuotePreviewSubscriptionSchedule,Subscription::CreateParams,SubscriptionSchedule::CreateParams,SubscriptionSchedule, andSubscription - Change 
Checkout::Session::AutomaticTax.provider,Invoice::AutomaticTax.provider,Quote::AutomaticTax.provider, andQuotePreviewInvoice::AutomaticTax.providerto be required - Add support for 
account_numberonConfirmationToken::PaymentMethodPreview::AcssDebitandPaymentMethod::AcssDebit 
 - Add support for 
 
15.1.0-beta.2 - 2025-04-17
- #1578 Update generated code for beta
- Add support for new resources 
FxQuoteandPaymentIntentAmountDetailsLineItem - Add support for 
create,list, andretrievemethods on resourceFxQuote - Remove support for 
attach_payment_intentmethod on resourceInvoice - Add support for 
registration_dateonAccount::Company,Account::CreateParams::Company,Account::UpdateParams::Company, andToken::CreateParams::Account::Company - Add support for 
customer_referenceandorder_referenceonCharge::CaptureParams::PaymentDetail,Charge::UpdateParams::PaymentDetail,PaymentIntent::CaptureParams::PaymentDetail,PaymentIntent::ConfirmParams::PaymentDetail,PaymentIntent::CreateParams::PaymentDetail,PaymentIntent::PaymentDetail, andPaymentIntent::UpdateParams::PaymentDetail - Add support for 
tax_idonCharge::BillingDetail,ConfirmationToken::CreateParams::PaymentMethodDatum::BillingDetail,ConfirmationToken::PaymentMethodPreview::BillingDetail,PaymentIntent::ConfirmParams::PaymentMethodDatum::BillingDetail,PaymentIntent::CreateParams::PaymentMethodDatum::BillingDetail,PaymentIntent::UpdateParams::PaymentMethodDatum::BillingDetail,PaymentMethod::BillingDetail,PaymentMethod::CreateParams::BillingDetail,PaymentMethod::UpdateParams::BillingDetail,SetupIntent::ConfirmParams::PaymentMethodDatum::BillingDetail,SetupIntent::CreateParams::PaymentMethodDatum::BillingDetail,SetupIntent::UpdateParams::PaymentMethodDatum::BillingDetail, andTreasuryOutboundPayment::CreateParams::DestinationPaymentMethodDatum::BillingDetail - Add support for 
price_dataonCheckoutSession::UpdateParams::LineItem - Change type of 
CheckoutSession::UpdateParams::LineItem.quantityfromlongIntegertoemptyable(longInteger) - Add support for 
scriptonCoupon::CreateParamsandCoupon - Add support for 
typeonCoupon - Add support for 
fx_quoteonPaymentIntent::ConfirmParams,PaymentIntent::CreateParams,PaymentIntent::UpdateParams,PaymentIntent,Transfer::CreateParams, andTransfer - Add support for 
discount_amount,line_items,shipping, andtaxonPaymentIntent::AmountDetail - Add support for 
pixonPaymentMethodConfiguration::CreateParams,PaymentMethodConfiguration::UpdateParams, andPaymentMethodConfiguration - Add support for 
us_cfpb_dataonPersonandToken::CreateParams::Person - Add support for 
pending_reasononRefund - Add support for 
aw,az,bd,bj,et,kg,la, andphonTaxRegistration::CountryOptionandTaxRegistration::CreateParams::CountryOption 
 - Add support for new resources 
 - #1588 Removed Request signing authenticator
- Removed 
RequestSigningAuthenticatorclass as request signing is not supported by Stripe APIs yet. This allows us to remove the dependency on base64 
 - Removed 
 - #1582 Prathmesh/merge ruby beta
 
15.1.0-beta.1 - 2025-04-10
- 
#1569 Update generated code for beta
Breaking changes
- Change type of 
V2MoneyManagementReceivedDebit.status_transitionsfroman objecttonullable(an object) 
Additions
- Add support for new resources 
Privacy::RedactionJobRootObjects,Privacy::RedactionJobValidationError, andPrivacy::RedactionJob - Add support for 
cancel,create,list,retrieve,run,update, andvalidatemethods on resourceRedactionJob - Add support for 
listandretrievemethods on resourceRedactionJobValidationError - Add support for 
minority_owned_business_designationonAccount::BusinessProfile,Account::CreateParams::BusinessProfile, andAccount::UpdateParams::BusinessProfile - Add support for 
export_tax_transactionsandpayment_disputesonAccountSession::CreateParams::Component - Add support for 
wallet_optionsonCheckoutSession::CreateParamsandCheckoutSession - Add support for 
klarnaonPaymentMethodDomain - Change type of 
TaxCalculationLineItem.referencefromnullable(string)tostring - Add support for 
inonTaxRegistration::CountryOptionandTaxRegistration::CreateParams::CountryOption 
 - Change type of 
 - 
#1572 Handle external_account field
- Changes 
external_accountfield inexternal_accounts.createfrom astringto a union type. 
 - Changes 
 
15.0.0 - 2025-04-09
Breaking change
- 
#1574 Rename
object_idin V2::Core::EventService::ListParams toobject_id_- ⚠️ Change name of parameter from 
object_idtoobject_id_onStripe::V2::Core::EventService::ListParamsto avoid conflict with Ruby native attribute, as found in https://github.com/stripe/stripe-ruby/issues/1567 - This is a no-op unless you are using this specific parameter that was introduced in 
v14.0.0 
 - ⚠️ Change name of parameter from 
 - 
#1576 Explicitly pass through custom headers in retrieve
- Fix custom options passing for resource-based retrieve
 
 - 
#1571 Validate all instance variable keys returned from the API
- Validate all keys returned from the API, including custom response fields, to make sure they can be set in an instance variable, as brought up in https://github.com/stripe/stripe-ruby/issues/1564
- We do not set instance variables for invalid field names (as defined by the Ruby spec). We recommend for custom hash map response fields, use the 
[]accessor.c = client.v1.customers.retrieve("cus_123") c.metadata["invalid-variable-name!"] c.metadata["valid_key_name_works_too"] 
 - We do not set instance variables for invalid field names (as defined by the Ruby spec). We recommend for custom hash map response fields, use the 
 
 - Validate all keys returned from the API, including custom response fields, to make sure they can be set in an instance variable, as brought up in https://github.com/stripe/stripe-ruby/issues/1564
 - 
#1575 Remove unused youtube playlist link
 - 
#1573 Remove link for stale youtube video playlist
 
14.1.0-beta.1 - 2025-04-02
- 
#1563, #1558, #1547 Update generated code for beta
This release changes the pinned API version to
2025-03-31.previewBreaking changes
- Change type of 
QuotePreviewInvoice::Parent::SubscriptionDetail.subscriptionfromstringtoexpandable($Subscription) - Remove support for 
valueonTerminalReader::Action::CollectInput::Input::Selection::Choice,TerminalReader::Action::CollectInput::Input::Selection, andTerminalReader::CollectInputsParams::Input::Selection::Choice 
Additions
- Add support for 
payment_method_optionsonConfirmationToken::CreateParams - Add support for 
installmentsonConfirmationToken::PaymentMethodOption::Card - Change 
BillingCreditBalanceSummary::RetrieveParams.customer,BillingCreditBalanceTransaction::ListParams.customer,BillingCreditGrant::CreateParams.customer,BillingPortalSession::CreateParams.customer,CustomerSession::CreateParams.customer,InvoiceItem::CreateParams.customer,PaymentMethod::AttachParams.customer, andSubscription::CreateParams.customerto be optional - Add support for 
update_line_itemsonCheckoutSession::CreateParams::PermissionandCheckoutSession::Permission - Add support for 
billieonPaymentIntent::ConfirmParams::PaymentMethodOption,PaymentIntent::CreateParams::PaymentMethodOption,PaymentIntent::PaymentMethodOption, andPaymentIntent::UpdateParams::PaymentMethodOption - Add support for 
idandtextonTerminalReader::Action::CollectInput::Input::Selection::Choice,TerminalReader::Action::CollectInput::Input::Selection, andTerminalReader::CollectInputsParams::Input::Selection::Choice - Add support for new resources 
BalanceSettings - Add support for 
retrieveandupdatemethods on resourceBalanceSettings - Add support for 
create,delete,list,retrieve, andupdatemethods on a newExternalAccountServiceclass to access cards and bank accounts made available in the new pathv1/external_accounts. Access this viaStripeClient.external_accounts 
New APIs for Money CardManagement
- Add support for new resources 
V2::Core::Vault::UsBankAccount,V2::FinancialAddressCreditSimulation,V2::FinancialAddressGeneratedMicrodeposits,V2::MoneyManagement::Adjustment,V2::MoneyManagement::FinancialAccount,V2::MoneyManagement::FinancialAddress,V2::MoneyManagement::InboundTransfer,V2::MoneyManagement::OutboundPaymentQuote,V2::MoneyManagement::OutboundPayment,V2::MoneyManagement::OutboundSetupIntent,V2::MoneyManagement::OutboundTransfer,V2::MoneyManagement::PayoutMethod,V2::MoneyManagement::PayoutMethodsBankAccountSpec,V2::MoneyManagement::ReceivedCredit,V2::MoneyManagement::ReceivedDebit,V2::MoneyManagement::TransactionEntry, andV2::MoneyManagement::Transaction - Add support for 
createmethod on resourceV2::MoneyManagement::OutboundPaymentQuote - Add support for 
listandretrievemethods on resourcesV2::MoneyManagement::Adjustment,V2::MoneyManagement::FinancialAccount,V2::MoneyManagement::ReceivedCredit,V2::MoneyManagement::ReceivedDebit,V2::MoneyManagement::TransactionEntry, andV2::MoneyManagement::Transaction - Add support for 
create,list, andretrievemethods on resourcesV2::MoneyManagement::FinancialAddressandV2::MoneyManagement::InboundTransfer - Add support for 
cancel,create,list, andretrievemethods on resourcesV2::MoneyManagement::OutboundPaymentandV2::MoneyManagement::OutboundTransfer - Add support for 
archive,list,retrieve, andunarchivemethods on resourceV2::MoneyManagement::PayoutMethod - Add support for 
cancel,create,list,retrieve, andupdatemethods on resourceV2::MoneyManagement::OutboundSetupIntent - Add support for 
retrievemethod on resourceV2::MoneyManagement::PayoutMethodsBankAccountSpec - Add support for new thin event 
V2MoneyManagementFinancialAccountCreatedEventwith related objectV2::MoneyManagement::FinancialAccount - Add support for new thin events 
V2MoneyManagementFinancialAddressActivatedEventandV2MoneyManagementFinancialAddressFailedEventwith related objectV2::MoneyManagement::FinancialAddress - Add support for new thin events 
V2MoneyManagementInboundTransferAvailableEvent,V2MoneyManagementInboundTransferBankDebitFailedEvent,V2MoneyManagementInboundTransferBankDebitProcessingEvent,V2MoneyManagementInboundTransferBankDebitQueuedEvent,V2MoneyManagementInboundTransferBankDebitReturnedEvent, andV2MoneyManagementInboundTransferBankDebitSucceededEventwith related objectV2::MoneyManagement::InboundTransfer - Add support for new thin events 
V2MoneyManagementOutboundPaymentCanceledEvent,V2MoneyManagementOutboundPaymentCreatedEvent,V2MoneyManagementOutboundPaymentFailedEvent,V2MoneyManagementOutboundPaymentPostedEvent, andV2MoneyManagementOutboundPaymentReturnedEventwith related objectV2::MoneyManagement::OutboundPayment - Add support for new thin events 
V2MoneyManagementOutboundTransferCanceledEvent,V2MoneyManagementOutboundTransferCreatedEvent,V2MoneyManagementOutboundTransferFailedEvent,V2MoneyManagementOutboundTransferPostedEvent, andV2MoneyManagementOutboundTransferReturnedEventwith related objectV2::MoneyManagement::OutboundTransfer - Add support for new thin events 
V2MoneyManagementReceivedCreditAvailableEvent,V2MoneyManagementReceivedCreditFailedEvent,V2MoneyManagementReceivedCreditReturnedEvent, andV2MoneyManagementReceivedCreditSucceededEventwith related objectV2::MoneyManagement::ReceivedCredit - Add support for new thin events 
V2MoneyManagementReceivedDebitCanceledEvent,V2MoneyManagementReceivedDebitFailedEvent,V2MoneyManagementReceivedDebitPendingEvent,V2MoneyManagementReceivedDebitSucceededEvent, andV2MoneyManagementReceivedDebitUpdatedEventwith related objectV2::MoneyManagement::ReceivedDebit - Add support for new error types 
AlreadyCanceledError,BlockedByStripeError,ControlledByDashboardError,FeatureNotEnabledError,FinancialAccountNotOpenError,InsufficientFundsError,InvalidPayoutMethodError,NotCancelableError, andRecipientNotNotifiableError 
New APIs for Accounts v2 in private preview
See SaaS platform payments with subscription billing using Accounts v2
- Add support for new resources 
V2::Core::AccountLink,V2::Core::Account,V2::Core::Person,V2::Core::Vault::GbBankAccount,V2::Core::Vault::UsBankAccount - Add support for 
close,create,list,retrieve, andupdatemethods on resourceV2::Core::Account - Add support for 
createmethod on resourcesV2::Core::AccountLinkandV2::MoneyManagement::OutboundPaymentQuote - Add support for 
acknowledge_confirmation_of_payee,archive,create,initiate_confirmation_of_payee, andretrievemethods on resourceV2::Core::Vault::GbBankAccount - Add support for 
archive,create,retrieve, andupdatemethods on resourceV2::Core::Vault::UsBankAccount - Add support for new thin events 
V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,V2CoreAccountIncludingIdentityUpdatedEvent, andV2CoreAccountIncludingRequirementsUpdatedEvent - Add support for new thin event 
V2CoreAccountLinkCompletedEventwith related objectV2::Core::AccountLink - Add support for new thin events 
V2CoreAccountPersonCreatedEvent,V2CoreAccountPersonDeletedEvent, andV2CoreAccountPersonUpdatedEventwith related objectV2::Core::Person 
 - Change type of 
 - 
#1557 Update Stripe.add_beta_version
stripe.add_beta_versionwill use the highest version number used for a beta feature instead of raising anErroron a conflict as it had done previously.
 
14.0.0 - 2025-04-01
- 
#1559 Add RBI annotations for fields and params
- Adds explicit field types for resources and parameters for methods, and add RBI static annotations for all resources and services
 - See the wiki for more details
 
 - Adds explicit field types for resources and parameters for methods, and add RBI static annotations for all resources and services
 - 
#1543 Support for APIs in the new API version 2025-03-31.basil
This release changes the pinned API version to
2025-03-31.basil.⚠️ Breaking changes due to changes in the Stripe API
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
- Remove support for resources 
SubscriptionItemUsageRecordSummaryandSubscriptionItemUsageRecord - Remove support for 
createmethod on resourceSubscriptionItemUsageRecord - Remove support for 
listmethod on resourceSubscriptionItemUsageRecordSummary - Remove support for 
upcomingLinesandupcomingmethods on resourceInvoice 
⚠️ Other breaking changes in the SDK
- #1553 Remove public idempotent_replayed? method
- ⚠️ Remove the 
idempotent_replayed?method onStripeError- The information is accessible indirectly via the raw response headers, 
StripeResponse.http_headers. For example, useresource.last_response.http_headers['Idempotent-Replayed'] 
 - The information is accessible indirectly via the raw response headers, 
 
 - ⚠️ Remove the 
 
Additions to the Stripe API
- Add support for new resource 
InvoicePayment - Add support for 
listandretrievemethods on resourceInvoicePayment 
 - Remove support for resources 
 
13.6.0-beta.1 - 2025-03-18
- 
#1550 Merge from stripe-ruby master
 - 
#1546 Beta SDK updates between Open API versions 1473 and 1505
- Add support for 
succeed_input_collectionandtimeout_input_collectiontest helper methods on resourceTerminal.Reader 
 - Add support for 
 - 
#1545 fix ruby merge conflict for beta
 
13.5.0-beta.1 - 2025-02-07
- #1527 Update generated code for beta
 
13.5.0 - 2025-02-24
- #1534 Update generated code
- Fixed 
Stripe::InvoiceLineItem.updatemethod. 
 - Fixed 
 - #1536 Fix InvoiceLineItem parent class
- Fix bug where 
Stripe::InvoiceLineItemhad the incorrect parent class, making it error whenupdatewas called 
 - Fix bug where 
 - #1533 add codeowners file
 
13.4.1 - 2025-01-28
- #1528 Update generated code
- ⚠️ Bugfix: 
invoiceandline_item_idcan be passed toupdatemethod inInvoiceLineItem. 
 - ⚠️ Bugfix: 
 
13.4.0 - 2025-01-27
- #1510 Update generated code
- Add support for 
closemethod on resourceTreasury.FinancialAccount 
 - Add support for 
 - #1521 pipe rubocop output to devnull
 - #1519 Fixed typos in CONTRIBUTING.MD
 - #1513 add justfile
 - #1515 Added CONTRIBUTING.md file
 
13.4.0-beta.4 - 2025-01-23
- #1523 Update generated code for beta
- Removed support for 
stripe_accountfromStripe::Terminal::Reader. Useaccountinstead. 
 - Removed support for 
 
13.4.0-beta.3 - 2025-01-17
- #1514 Update generated code for beta
 
13.4.0-beta.2 - 2025-01-09
- #1504 Update generated code for beta
- Add support for 
closemethod on resourceTreasury.FinancialAccount 
 - Add support for 
 
13.4.0-beta.1 - 2024-12-20
- Support parameter and resource fields with typed RBIs
- 
#1509 (beta) Publish RBIs with gem
 - 
#1505 Add method parameter type classes to all resources and services
 - 
Add method parameter classes for all resources and service methods.
 - 
These changes are NOT breaking and are purely additive. The method parameter classes are not required, we still accept hashes as well as the new
RequestParamsclasses. Any additional gated parameters are still available to pass via hash. Resource fields define publicly documented fields and other deserialized fields are still accessible. 
 - 
 
13.3.1 - 2025-01-13
- #1512 Import global configuration for options not available on StripeClient options
- Fixes bug where 
StripeClientwas not falling back to global options for options that are not available to be set per-client 
 - Fixes bug where 
 - #1516 ThinEvent reason and livemode
- Add 
livemodeand optionalreasonfields to ThinEvent 
 - Add 
 - #1518 Pin ubuntu version in Test action
 - #1508 Added pull request template
 
13.3.0 - 2024-12-18
- 
#1500 This release changes the pinned API version to
2024-12-18.acacia. - 
#1507 Pass requestor to all deserialized objects including lists
- Fixes bug where 
StripeObjectretrieved from lists could not be used to make requests, such asrefresh 
 - Fixes bug where 
 
13.3.0-beta.3 - 2024-12-12
- #1499 Update generated code for beta
- Add support for 
AllowRedisplayonCardandSource - Add support for new values 
am_tin,ao_tin,ba_tin,bb_tin,bs_tin,cd_nif,gn_nif,kh_tin,me_pib,mk_vat,mr_nif,np_pan,sn_ninea,sr_fin,tj_tin,ug_tin,zm_tin, andzw_tinon enumsCheckoutSessionCollectedInformationTaxIdsTypeandOrderTaxDetailsTaxIdsType - Add support for new value 
network_fallbackon enumIssuingAuthorizationRequestHistoryReason - Remove support for 
AmountRefundedonPaymentRecord - Add support for 
AccountonTerminalReaderActionCollectPaymentMethod,TerminalReaderActionConfirmPaymentIntent,TerminalReaderActionProcessPaymentIntent, andTerminalReaderActionRefundPayment 
 - Add support for 
 
13.3.0-beta.2 - 2024-12-05
- 
#1492 Update generated code for beta
 - 
#1490 Add explicit attributes for fields in resources, and rbis for resources
 
13.3.0-beta.1 - 2024-11-21
- #1489 Merging code from master to get the latest bug fixes.
 
13.2.0 - 2024-11-20
- #1486 This release changes the pinned API version to 
2024-11-20.acacia.- Add support for 
respondtest helper method on resourceIssuing.Authorization 
 - Add support for 
 
13.2.0-beta.3 - 2024-11-14
- #1484 Update generated code for beta
 
13.2.0-beta.2 - 2024-11-07
- #1480 Update generated code for beta
- Add support for new resources 
Issuing.FraudLiabilityDebit,PaymentAttemptRecord, andPaymentRecord - Add support for 
listandretrievemethods on resourcesFraudLiabilityDebitandPaymentAttemptRecord - Add support for 
report_payment_attempt_canceled,report_payment_attempt_failed,report_payment_attempt_guaranteed,report_payment_attempt,report_payment, andretrievemethods on resourcePaymentRecord 
 - Add support for new resources 
 
13.2.0-beta.1 - 2024-10-29
- #1477 Update generated code for beta
- Add support for 
trigger_actionmethod on resourcePaymentIntent 
 - Add support for 
 
13.1.2 - 2024-11-15
- #1488 Fix incorrect key in param encoding
 
13.1.1 - 2024-11-06
- #1483 Fix APIResource#retrieve not sending 
stripe_version 
13.1.0 - 2024-10-29
- #1472 This release changes the pinned API version to 
2024-10-28.acacia.- Add support for 
submit_cardtest helper method on resourceIssuing.Card - Add support for new resource 
V2.EventDestinations - Add support for 
create,retrieve,update,list,delete,disable,enableandpingmethods on resourceV2.EventDestinations 
 - Add support for 
 - #1476 Fix APIResource#retrieve bug not returning instance of custom resources
- Fix bug in APIResource#refresh and APIResource#retrieve where they returned an instance of 
StripeObjectfor custom resources. They should now return the instance of the custom resource. 
 - Fix bug in APIResource#refresh and APIResource#retrieve where they returned an instance of 
 
13.1.0-beta.3 - 2024-10-18
- #1469 Update generated code for beta
 
13.1.0-beta.2 - 2024-10-08
- #1468 Update generated code for beta
- Add support for 
submit_cardtest helper method on resourceIssuing.Card 
 - Add support for 
 
13.1.0-beta.1 - 2024-10-03
- #1465 Updates to the 
Previewclass- Remove 
Stripe::Preview. UseStripeClient#raw_requestinstead (see below). - Marked 
Stripe.raw_requestandStripe.deserializeas deprecated. UseStripeClient#raw_requestandStripeClient#deserializeinstead. In StripeClient, the params and opts parameters are passed as keyword arguments:# Before resp = Stripe.raw_request(:post, "v1/charges", , {p1: "p1"}, {stripe_account: "acct_123"}) charge = Stripe.deserialize(resp.data) # After client = StripeClient.new("sk_test_123") resp = client.raw_request(:post, "/v1/charges", params: {p1: "p1"}, opts: {stripe_account: "acct_123"}) charge = client.deserialize(resp.data) 
 - Remove 
 
13.0.2 - 2024-10-23
- 
#1473 Always return the result of APIResource#refresh in APIResource.retrieve
- Fix bug where we would not return the mutated 
selfobject when callingAPIResource.retrieve 
 - Fix bug where we would not return the mutated 
 
13.0.1 - 2024-10-18
- 
#1471 update object tags for meter-related classes
- fixes a bug where the 
objectproperty of theMeterEvent,MeterEventAdjustment, andMeterEventSessiondidn't match the server. 
 - fixes a bug where the 
 - 
#1470 Cleaned up examples and added documentation
 
13.0.0 - 2024-10-01
- 
#1458 Support for APIs in the new API version 2024-09-30.acacia
This release changes the pinned API version to
2024-09-30.acacia. Please read the API Upgrade Guide and carefully review the API changes before upgrading.⚠️ Breaking changes
Please refer to our migration guide for v13 for more information about the backwards incompatible changes.
❗
StripeClientand related changes- Move 
StripeClientand requestor logic toAPIRequestor.StripeClient#requestis still available, but is deprecated and will be removed. We encourageStripeClient#raw_requestas a replacement (see other breaking changes for more detail).
 - Repurpose and introduce 
StripeClientas the the entry-point to the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm. Services are available under thev1andv2accessors.- No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
 - No extra API calls. All API endpoints can be accessed with a single method call. You don't have to call 
retrievebefore doing anupdate. - No static methods. Much easier mocking.
 
 
Other breaking changes
- Adjust default values around retries for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
- max retries: 
0->2 - max retry delay (seconds) 
2->5 
 - max retries: 
 - Remove 
StripeClient#connection_manager. This was a legacy method from years ago. - Singleton 
retrievemethod now requiresparamsto be passed as the first argument. Existing calls to singletonretrievemethod with onlyoptsargument will have to be updated to account for the addition ofparamsargument.params = { expand: ["available"] } opts = { stripe_account: "acct_123" } # ❌ No longer works Stripe::Balance.retrieve(opts) # ✅ Correct way to call retrieve method Stripe::Balance.retrieve(params, opts) - Moved the 
Stripe.raw_request()method that was recently added toStripeClient. This will use the configuration set on the StripeClient instead of the global configuration used before. - Remove 
APIResource.request. Instead, useStripeClient#raw_requestnow.# Instead of Stripe::APIResource.request(:get, "/v1/endpoint", params, opts) # do client = Stripe::StripeClient.new(...) resp = client.raw_request(:get, "/v1/endpoint", params: params, opts: opts) - Add an additional parameter to 
APIResource.execute_resource_request. However, we discourage use of this in favor ofStripeClient#raw_request.APIResource.execute_resource_request(method, url, params = {}, opts = {}, usage = []) # is now, with base_address being one of [:api, :files, :connect, :meter_events] APIResource.execute_resource_request(method, url, base_address = :api, params = {}, opts = {}, usage = []) - Change parameters to 
APIRequestor.execute_request(previouslyStripeClient.execute_request). It now returns all request options from our internal request framework as the second value in the returned tuple, instead of only the API key used:# Before obj, api_key = StripeClient.execute_request(method, path, api_base: nil, api_key: nil, headers: {}, params: {}, usage: []) # is now, with base_address being one of [:api, :files, :connect, :meter_events] obj, opts = APIRequestor.execute_request(method, path, base_address, params: {}, opts: {}, usage: []) puts(opts) # will output {api_key: "sk_test_123", stripe_account: "acct_123"} 
Additions
- Add support for new Usage Billing APIs 
Billing.MeterEvent,Billing.MeterEventAdjustments,Billing.MeterEventSession,Billing.MeterEventStreamand the new Events APICore.Eventsin the v2 namespace - Add method 
parse_thin_event()on theStripeClientclass to parse thin events. 
 - Move 
 
12.7.0-beta.2 - 2024-09-18
- #1449 Update generated code for beta
- Remove support for resource 
QuotePhase - Remove support for 
list_line_itemsandretrievemethods on resourceQuotePhase 
 - Remove support for resource 
 
12.7.0-beta.1 - 2024-09-13
- #1446 Update generated code for beta
- Add support for new resources 
Issuing.DisputeSettlementDetailandIssuing.Settlement - Add support for 
listandretrievemethods on resourceDisputeSettlementDetail - Remove support for 
listmethod on resourceQuotePhase 
 - Add support for new resources 
 
12.6.0 - 2024-09-12
- #1442 Update generated code
- Add support for new resource 
InvoiceRenderingTemplate - Add support for 
archive,list,retrieve, andunarchivemethods on resourceInvoiceRenderingTemplate 
 - Add support for new resource 
 - #1443 Removed v1/files override
 
12.6.0-beta.1 - 2024-09-05
- #1441 Update generated code for beta
- Add support for new resources 
Billing.MeterErrorReportandTerminal.ReaderCollectedData - Add support for 
retrievemethod on resourceReaderCollectedData 
 - Add support for new resources 
 
12.5.0 - 2024-08-08
- #1440 Update generated code
- Add support for new resources 
Billing.AlertTriggeredandBilling.Alert - Add support for 
activate,archive,create,deactivate,list, andretrievemethods on resourceAlert - Add support for 
retrievemethod on resourceTax.Calculation 
 - Add support for new resources 
 
12.5.0-beta.2 - 2024-08-01
- #1439 Update generated code for beta
- Add support for 
attach_paymentmethod on resourceInvoice 
 - Add support for 
 
12.5.0-beta.1 - 2024-07-25
- #1429 Update generated code for beta
- Add support for new resources 
Billing.AlertTriggered,Billing.Alert, andTax.Association - Add support for 
activate,archive,create,deactivate,list, andretrievemethods on resourceAlert - Add support for 
findmethod on resourceAssociation 
 - Add support for new resources 
 - #1434 Merge changes from stripe/stripe-ruby master
 
12.4.0 - 2024-07-25
- #1437 Update generated code
- Add support for 
updatemethod on resourceCheckout.Session 
 - Add support for 
 
12.3.0 - 2024-07-18
- #1436 Fixed changelog for major release 12.0.0
 - #1435 Add deprecation warning for 
APIResource.request 
12.2.0 - 2024-07-12
- 
#1430 Update generated code
 - 
#1433 Add usage to raw_request call
 - 
#1431 Add
raw_request- Adds the ability to make raw requests to the Stripe API, by providing an HTTP method and url. This is an alternative to using 
Stripe::APIResource.request(...)to make custom requests, which is discouraged and will be broken in a future major version. 
 - Adds the ability to make raw requests to the Stripe API, by providing an HTTP method and url. This is an alternative to using 
 
12.2.0-beta.1 - 2024-07-05
- #1428 Update generated code for beta
- Add support for new resource 
FinancialConnections.Institution - Add support for 
listandretrievemethods on resourceInstitution 
 - Add support for new resource 
 - #1409 Update generated code for beta
 
12.1.0 - 2024-07-05
- #1425 Update generated code
- Add support for 
add_lines,remove_lines, andupdate_linesmethods on resourceInvoice 
 - Add support for 
 - #1420 Update static methods for delete/list on BankAccount/Card to throw NotImplementedError
- The below methods have been throwing 
InvalidRequestErrorbecause the urls used to make the requests have been buggy. Updating them to throwNotImplementedErrorinstead just like their counterparts for update & retrieve because they cannot be implemented without the parent id. 
Methods affected Use these instead in the context of payment method Use these in the context of external accounts Stripe:: BankAccount.delete Stripe::Customer.delete_source Stripe::Account.delete_external_account Stripe:: BankAccount.list Stripe::Customer.list_sources Stripe::Customer.list_external_accounts Stripe:: Card.delete Stripe::Customer.delete_source Stripe::Account.delete_external_account Stripe:: Card.list Stripe::Customer.list_sources Stripe::Customer.list_external_accounts  - The below methods have been throwing 
 - #1427 Regenerate rbis
 - #1426 Remove coveralls and re-added JRuby
 
12.0.0 - 2024-06-24
- 
#1418 Add missing static method for verify on BankAccount
 - 
This release changes the pinned API version to 2024-06-20. Please read the API Upgrade Guide and carefully review the API changes before upgrading.
Additions
- Add support for 
finalize_amounttest helper method on resourceIssuing.Authorization 
 - Add support for 
 
11.7.0 - 2024-06-13
- #1415 Deprecate StripeClient#request
- Add deprecation warning for 
StripeClient#request. This helper method will be removed in a future major version. To access response objects, use thelast_responseproperty on the returned resource instead. Refer to Accessing a response object in the README for usage details. 
 - Add deprecation warning for 
 
11.7.0-beta.1 - 2024-05-30
- #1400 Update generated code for beta
- Keeping up with the changes from version 11.6.0
 
 
11.6.0 - 2024-05-30
- #1404 Add method to list invoice line items
- Add methods 
list_lines()on the classInvoiceto list the invoice line items 
 - Add methods 
 
11.5.0 - 2024-05-23
- This release has no changes.
 
11.5.0-beta.1 - 2024-05-09
- #1395 Update generated code for beta
- No new beta features. Merging changes from the main branch.
 
 
11.4.0 - 2024-05-09
- #1397 Update generated code
- Add support for 
updatetest helper method on resourcesTreasury.OutboundPaymentandTreasury.OutboundTransfer 
 - Add support for 
 - #1399 Pass params to transfer reversal
- Allow 
Stripe::Transfer.retrieve_reversal()to accept a params hash as the third argument, followed by opts. No changes to existing calls are necessary, but in a future major version this method will be updated to only accept params as the first argument. Fixes #1393 
 - Allow 
 - #1389 Removed jaro_winkler as a dependency
 - #1396 Start tracking 
StripeClient#requestusage 
11.4.0-beta.1 - 2024-05-02
- #1386 Update generated code for beta
 
11.3.0 - 2024-05-02
- 
#1387 Update generated code
 - 
#1392 Deprecate Ruby methods based on OpenAPI spec
- Mark as deprecated the 
approveanddeclinemethods inlib/stripe/resources/issuing/authorization.rb. Instead, respond directly to the webhook request to approve an authorization. 
 - Mark as deprecated the 
 - 
#1391 Add Ruby 3.3 to CI test matrix
 
11.3.0-beta.1 - 2024-04-18
- #1383 Update generated code for beta
 
11.2.0 - 2024-04-18
- #1385 Update generated code
- Add support for 
create_previewmethod on resourceInvoice 
 - Add support for 
 
11.1.0 - 2024-04-16
- #1379 Update generated code
- Add support for new resource 
Entitlements.ActiveEntitlementSummary 
 - Add support for new resource 
 
11.1.0-beta.1 - 2024-04-11
- #1376 Update generated code for beta
- Add support for 
retrievemethod on resourcesEntitlements.ActiveEntitlementandEntitlements.Feature 
 - Add support for 
 
11.0.0 - 2024-04-10
- 
- This release changes the pinned API version to 
2024-04-10. Please read the API Upgrade Guide and carefully review the API changes before upgrading. 
⚠️ Breaking changes
- When no 
x-stripe-should-retryheader is set in the response, the library now retries all requests withstatus >= 500, not just non-POST methods. 
 - This release changes the pinned API version to 
 
10.15.0 - 2024-04-09
- #1377 Add last_response to StripeObject
- Users can now retrieve raw response from the returned resource, using the 
last_responseproperty. See README for an example. 
 - Users can now retrieve raw response from the returned resource, using the 
 - #1372 Update generated code
- Add support for new resources 
Entitlements.ActiveEntitlementandEntitlements.Feature - Add support for 
listandretrievemethods on resourceActiveEntitlement - Add support for 
create,list,retrieve, andupdatemethods on resourceFeature 
 - Add support for new resources 
 - #1366 Move executables to 
exefolder 
10.15.0-beta.1 - 2024-04-04
- #1373 Update generated code for beta
- Add support for 
updatemethod on resourceEntitlements.Feature 
 - Add support for 
 - #1370 Update generated code for beta
 
10.14.0 - 2024-03-28
- #1369 Update generated code
- Add support for new resources 
Billing.MeterEventAdjustment,Billing.MeterEvent, andBilling.Meter - Add support for 
create,deactivate,list,reactivate,retrieve, andupdatemethods on resourceMeter - Add support for 
createmethod on resourcesMeterEventAdjustmentandMeterEvent 
 - Add support for new resources 
 
10.14.0-beta.1 - 2024-03-21
- #1363 Update generated code for beta
- Add support for new resources 
Entitlements.ActiveEntitlementSummaryandEntitlements.ActiveEntitlement - Add support for 
listmethod on resourceActiveEntitlement 
 - Add support for new resources 
 
10.13.0 - 2024-03-21
- #1367 Update generated code
- Add support for new resources 
ConfirmationTokenandForwarding.Request - Add support for 
retrievemethod on resourceConfirmationToken - Add support for 
create,list, andretrievemethods on resourceRequest 
 - Add support for new resources 
 - #1362 Exclude sorbet directory and tapioca script when packing gem
 
10.13.0-beta.1 - 2024-03-14
- #1360 Update generated code for beta
- Add support for new resources 
Billing.MeterEventAdjustment,Billing.MeterEvent, andBilling.Meter - Add support for 
create,deactivate,list,reactivate,retrieve, andupdatemethods on resourceMeter - Add support for 
createmethod on resourcesMeterEventAdjustmentandMeterEvent - Add support for 
createtest helper method on resourceConfirmationToken - Add support for 
add_lines,remove_lines, andupdate_linesmethods on resourceInvoice 
 - Add support for new resources 
 
10.12.0 - 2024-03-14
- #1359 Update generated code
- Add support for new resources 
Issuing.PersonalizationDesignandIssuing.PhysicalBundle - Add support for 
create,list,retrieve, andupdatemethods on resourcePersonalizationDesign - Add support for 
listandretrievemethods on resourcePhysicalBundle 
 - Add support for new resources 
 - #1354 Refactor after SDK based generation pattern
 - #1347 Reorder methods with lexographical sort
 - #1355 Disable Metrics/ClassLength
 - #1351 Update CHANGELOG.md
 
10.12.0-beta.1 - 2024-02-29
- 
#1352 Update generated code for beta Release specs are identical.
 - 
#1350 Update generated code for beta
 - 
#1341 Update generated code for beta
- Remove support for resource 
Entitlements.Event 
 - Remove support for resource 
 - 
#1343 Add a helper to add a beta version
 
10.11.0 - 2024-02-29
- #1348 Use sorbet gem instead of sorbet-static
 - #1342 Update generated code
- Add 
list_refundsandretrieve_refundmethods on resourceCharge. 
 - Add 
 - #1345 Update README to use add_beta_version
 
10.11.0-beta.1 - 2024-02-22
- #1335 Update generated code for beta
 
10.10.0 - 2024-02-22
- #1336 Update generated code
- Add 
InvoiceLineItem.updatemethod. 
 - Add 
 - #1334 Add TaxIds API
- Add support for 
all,create, andretrievemethods on resourceTaxId - The 
deletemethod now sends a DELETE request to/v1/tax_ids/{id}instead of/v1/customers/{customer}/tax_ids/{id}. The endpoints are functionally the same when operating on a Customer Tax ID. - The 
resource_urlmethod onTaxIdnow returns the top-level/v1/tax_ids/{id}path instead of the/v1/customers/{customer}/tax_ids/{id}path. 
 - Add support for 
 
10.10.0-beta.1 - 2024-02-16
- #1332 Update generated code for beta
- Add support for 
decrement_authorizationmethod on resourcePaymentIntent 
 - Add support for 
 - #1328 Update generated code for beta
 
10.9.0 - 2024-02-15
- #1329 Update generated code
- Fixed bug where 
TaxIdresourcedeletemethod sent request to wrong URL (https://github.com/stripe/stripe-ruby/issues/1333) 
 - Fixed bug where 
 - #1324 Start running Sorbet in CI
 - #1327 Add methods for dynamically referenced constants
 
10.9.0-beta.1 - 2024-02-08
- #1321 Update generated code for beta
- Release specs are identical.
 
 
10.8.0 - 2024-02-08
- #1322 Update generated code
 - #1323 Extract other CRUDL api operations from mixins
- Extract more CRUDL operations, namely 
create,delete,update, andlistinto the resources. These methods will no longer rely on the APIOperation mixins. 
 - Extract more CRUDL operations, namely 
 - #1314 Update mocha gem to 1.16
 
10.8.0-beta.1 - 2024-02-01
- #1318 Update generated code for beta
- Add support for new resources 
Entitlements.EventandEntitlements.Feature - Add support for 
createmethod on resourceEvent - Add support for 
createandlistmethods on resourceFeature 
 - Add support for new resources 
 
10.7.1 - 2024-02-05
- #1320 Remove spurious _search deprecation messages (https://github.com/stripe/stripe-ruby/issues/1319)
 
10.7.0 - 2024-02-01
- #1317 Remove list method in child resources
- Removes list method mixin from child resources, as these methods always return 
InvalidRequestErrorand never succeed 
 - Removes list method mixin from child resources, as these methods always return 
 - #1311 Use the deprecation gem in search and clean up usage of the gem
 
10.7.0-beta.3 - 2024-01-25
- #1313 Update generated code for beta
- Add support for 
create_previewmethod on resourceInvoice 
 - Add support for 
 - #1307 Beta: report raw request usage
 
10.7.0-beta.2 - 2024-01-19
- #1307 Beta: report raw request usage
 
10.7.0-beta.1 - 2024-01-12
10.6.0 - 2024-01-12
- #1310 Update generated code
- Add support for new resource 
CustomerSession - Add support for 
createmethod on resourceCustomerSession 
 - Add support for new resource 
 
10.6.0-beta.1 - 2024-01-04
- #1302 Update generated code for beta
- Updated stable APIs to the latest version
 
 
10.5.0 - 2024-01-04
- #1306 Update generated code
- Add support for 
retrievemethod on resourceTax.Registration 
 - Add support for 
 
10.5.0-beta.1 - 2023-12-22
- #1302 Update generated code for beta
 
10.4.0 - 2023-12-22
- #1303 Update generated code
- Add support for new resource 
FinancialConnections.Transaction - Add support for 
listandretrievemethods on resourceTransaction - Add support for 
subscribeandunsubscribemethods on resourceFinancialConnections.Account 
 - Add support for new resource 
 - #1304 Add support for updatable singleton resources
 
10.4.0-beta.1 - 2023-12-14
Updated stable APIs to the latest version
10.3.0 - 2023-12-14
- #1294 Support sending parameters inside singleton retrieve
 
10.3.0-beta.1 - 2023-11-30
10.2.0 - 2023-11-30
- 
#1292 Update generated code
- Add support for new resources 
Climate.Order,Climate.Product, andClimate.Supplier - Add support for 
cancel,create,list,retrieve, andupdatemethods on resourceOrder - Add support for 
listandretrievemethods on resourcesProductandSupplier 
 - Add support for new resources 
 - 
#1295 Upgrade rubocop
 - 
#1291 Update generated code
 - 
#1290 Update generated code
 - 
#1288 Update generated code
 
10.2.0-beta.1 - 2023-11-02
- #1287 Update generated code for beta
- Add support for 
attach_payment_intentmethod on resourceInvoice 
 - Add support for 
 - #1285 Update generated code for beta
 
10.1.0 - 2023-11-02
- #1286 Update generated code
- Add support for new resource 
Tax.Registration - Add support for 
create,list, andupdatemethods on resourceRegistration 
 - Add support for new resource 
 
10.1.0-beta.2 - 2023-10-26
- #1285 Update generated code for beta
- Add support for new resource 
Margin - Add support for 
create,list,retrieve, andupdatemethods on resourceMargin 
 - Add support for new resource 
 
10.1.0-beta.1 - 2023-10-17
- #1284 Update generated code for beta
- Update pinned API version to 
2023-10-16 
 - Update pinned API version to 
 - #1282 Update generated code for beta
 
10.0.0 - 2023-10-16
- This release changes the pinned API version to 
2023-10-16. Please read the API Upgrade Guide and carefully review the API changes before upgradingstripe-ruby. - #1283 Update generated code
- Updated pinned API version
 
 - #1281 Update generated code
- Documentation only changes
 
 
9.5.0-beta.2 - 2023-10-12
- #1280 Update generated code for beta
- Add support for new resources 
AccountNoticeandIssuing.CreditUnderwritingRecord - Add support for 
list,retrieve, andupdatemethods on resourceAccountNotice - Add support for 
correct,create_from_application,create_from_proactive_review,list,report_decision, andretrievemethods on resourceCreditUnderwritingRecord 
 - Add support for new resources 
 
9.5.0-beta.1 - 2023-10-05
- #1278 Update generated code for beta
- Add support for 
mark_draftandmark_stalemethods on resourceQuote - Remove support for 
draft_quoteandmark_stale_quotemethods on resourceQuote - Rename 
preview_invoice_linestolist_preview_invoice_lineson resourceQuote 
 - Add support for 
 
9.4.0 - 2023-10-05
- #1277 Update generated code
- Add support for new resources 
Issuing.Token - Add support for 
list,retrieve, andupdatemethods on resourceToken 
 - Add support for new resources 
 
9.4.0-beta.3 - 2023-09-28
- #1276 Update generated code for beta
- Rename resources 
Issuing.CardDesignandIssuing.CardBundletoIssuing.PersonalizationDesignandIssuing.PhysicalBundle 
 - Rename resources 
 
9.4.0-beta.2 - 2023-09-21
- #1273 Update generated code for beta
 
9.4.0-beta.1 - 2023-09-14
- Updated stable APIs to the latest version
 
9.3.0 - 2023-09-14
- #1272 Update generated code
- Add support for new resource 
PaymentMethodConfiguration - Add support for 
create,list,retrieve, andupdatemethods on resourcePaymentMethodConfiguration 
 - Add support for new resource 
 - #1271 Update generated code
- Add support for 
capture,create,expire,increment, andreversetest helper methods on resourceIssuing.Authorization - Add support for 
create_force_capture,create_unlinked_refund, andrefundtest helper methods on resourceIssuing.Transaction 
 - Add support for 
 
9.3.0-beta.1 - 2023-09-07
- 
#1269 Update generated code for beta
- Release specs are identical.
 
 - 
#1268 Update generated code for beta
- Remove support for 
submit_cardtest helper method on resourceIssuing.Card 
 - Remove support for 
 - 
#1265 Update generated code for beta
- Rename 
Quote.preview_invoicestoQuotePreviewInvoice.listandQuote.preview_schedulestoQuotePreviewSchedules.list 
 - Rename 
 - 
#1264 Update generated code for beta
- Add support for new resources 
QuotePreviewInvoiceandQuotePreviewSchedule 
 - Add support for new resources 
 - 
#1259 Update generated code for beta
 - 
#1257 Update generated code for beta
 - 
#1254 Update generated code for beta
- Add support for 
submit_cardtest helper method on resourceIssuing.Card 
 - Add support for 
 - 
#1252 Remove developer_message support
 
9.2.0 - 2023-09-07
- #1267 Update generated code
- Add support for new resource 
PaymentMethodDomain - Add support for 
create,list,retrieve,update, andvalidatemethods on resourcePaymentMethodDomain 
 - Add support for new resource 
 
9.2.0-beta.1 - 2023-08-31
- #1265 Update generated code for beta
- Rename 
Quote.preview_invoicestoQuotePreviewInvoice.listandQuote.preview_schedulestoQuotePreviewSchedules.list 
 - Rename 
 
9.1.0 - 2023-08-31
- #1266 Update generated code
- Add support for new resource 
AccountSession - Add support for 
createmethod on resourceAccountSession 
 - Add support for new resource 
 - #1262 Explicitly format timestamp in SignatureVerificationError message
 
9.0.0 - 2023-08-16
⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️
- 
#1253 #1260 Pin latest API version as the default
In this release, Stripe API Version
2023-08-16(the latest at time of release) will be sent by default on all requests. This is a significant change with wide ramifications. The API version affects the properties you see on responses, the parameters you are allowed to send on requests, and so on. The previous default was to use your Stripe account's default API version.To successfully upgrade to stripe-ruby v9, you must either
- 
(Recommended) Upgrade your integration to be compatible with API Version
2023-08-16.Please read the API Changelog carefully for each API Version from
2023-08-16back to your Stripe account's default API version. Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe Test Mode before deploying them to production.You can read the v9 migration guide for more detailed instructions.
 - 
(Alternative option) Specify a version other than
2023-08-16when initializingstripe-ruby.If you were previously initializing stripe-ruby without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your Stripe account's default API version. For example:
require 'stripe' Stripe.api_key = "sk_test_..." + Stripe.api_version = '2020-08-27'If you were already initializing stripe-ruby with an explicit API Version, upgrading to v9 will not affect your integration.
Read the v9 migration guide for more details.
 
Going forward, each major release of this library will be pinned by default to the latest Stripe API Version at the time of release.
That is, instead of upgrading stripe-ruby and separately upgrading your Stripe API Version through the Stripe Dashboard. whenever you upgrade major versions of stripe-ruby, you should also upgrade your integration to be compatible with the latest Stripe API version.
 - 
 
9.0.0-beta.1 - 2023-08-24
- #1264 Update generated code for beta
- Add support for new resources 
QuotePreviewInvoiceandQuotePreviewSchedule 
 - Add support for new resources 
 - #1259 Update generated code for beta
 
8.8.0-beta.1 - 2023-08-10
- #1257 Update generated code for beta
- Updated stable APIs to the latest version
 
 
8.7.0 - 2023-08-10
- #1256 Update generated code
Add resources 
Tax::CalculationLineItem,Tax::TransactionLineItem, andTreasury::FinancialAccountFeatures. These resources have no methods on them, but do represent the return type of methods elsewhere. 
8.7.0-beta.3 - 2023-08-03
- #1254 Update generated code for beta
- Add support for 
submit_cardtest helper method on resourceIssuing.Card 
 - Add support for 
 - #1252 Remove developer_message support
 
8.7.0-beta.2 - 2023-07-28
- #1251 Update generated code for beta
- Add support for new resource 
Tax.Form - Add support for 
list,pdf, andretrievemethods on resourceForm 
 - Add support for new resource 
 - #1249 Update generated code for beta
 - #1246 Update generated code for beta
 
8.7.0-beta.1 - 2023-07-13
- #1245 Update generated code for beta Release specs are identical.
 - #1243 Update generated code for beta
- Add support for new resource 
PaymentMethodConfiguration - Add support for 
create,list,retrieve, andupdatemethods on resourcePaymentMethodConfiguration 
 - Add support for new resource 
 - #1239 Update generated code for beta
 
8.6.0 - 2023-07-13
- 
#1244 Update generated code
- Add support for new resource 
Tax.Settings - Add support for 
retrieveandupdatemethods on resourceSettings 
 - Add support for new resource 
 - 
#1241 Update generated code
 - 
#1209 Update shoulda-context version
 - 
#1235 Allow "error" string as log level
 - 
#1238 Update log level error message to include
error - 
#1231 fix: variable typo in README for instrumentation
 - 
#1234 Update generated code
 - 
#1230 Update generated code
- Release specs are identical.
 
 - 
#1226 Update generated code
 - 
#1223 Update generated code
 - 
#1225 Downgrade jaro_winkler
 - 
#1219 Update generated code
Documentation updates.
 - 
#1215 Update generated code
 - 
#1208 Update generated code
 - 
#1204 Update generated code
 
8.6.0-beta.6 - 2023-06-22
- #1237 Update generated code for beta
- Add support for new resource 
CustomerSession - Add support for 
createmethod on resourceCustomerSession 
 - Add support for new resource 
 - #1233 Update generated code for beta
 - #1229 Update generated code for beta
 
8.6.0-beta.5 - 2023-06-01
- #1227 Update generated code for beta
 - #1228 Document raw_request
 - #1222 Update generated code for beta
 - #1224 Handle developer message in preview error responses
 
8.6.0-beta.4 - 2023-05-19
- #1220 Update generated code for beta
- Add support for 
subscribeandunsubscribemethods on resourceFinancialConnections.Account 
 - Add support for 
 - #1217 Add raw_request
 - #1216 Update generated code for beta
 - #1214 Update generated code for beta
 
8.6.0-beta.3 - 2023-04-17
8.6.0-beta.2 - 2023-04-13
- #1206 Update generated code for beta
- Add support for 
collect_payment_methodandconfirm_payment_intentmethods on resourceTerminal.Reader 
 - Add support for 
 - #1205 Update generated code for beta
 
8.6.0-beta.1 - 2023-03-30
- #1202 Update generated code for beta
 
8.5.0 - 2023-03-30
- #1203 Update generated code
- Remove support for 
createmethod on resourceTax.Transaction- This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the 
create_from_calculationmethod. 
 - This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the 
 
 - Remove support for 
 - #1201 Update save deprecation message
 
8.5.0-beta.1 - 2023-03-23
- #1194 Update generated code for beta (new)
- Add support for new resources 
Tax.CalculationLineItemandTax.TransactionLineItem - Add support for 
collect_inputsmethod on resourceTerminal.Reader 
 - Add support for new resources 
 
8.4.0 - 2023-03-23
- #1197 Update generated code (new)
- Add support for new resources 
Tax.CalculationLineItem,Tax.Calculation,Tax.TransactionLineItem, andTax.Transaction - Add support for 
createandlist_line_itemsmethods on resourceCalculation - Add support for 
create_from_calculation,create_reversal,create,list_line_items, andretrievemethods on resourceTransaction 
 - Add support for new resources 
 - #1152 Symbolize hash keys inside 
convert_to_stripe_object_with_params 
8.4.0-beta.4 - 2023-03-16
- #1189 Update generated code for beta (new)
- Add support for 
create_from_calculationmethod on resourceTax.Transaction 
 - Add support for 
 - #1188 Update generated code for beta (new)
- Remove support for resources 
Capital.FinancingOfferandCapital.FinancingSummary - Remove support for 
list,mark_delivered, andretrievemethods on resourceFinancingOffer - Remove support for 
retrievemethod on resourceFinancingSummary 
 - Remove support for resources 
 - #1187 Merge upstream master
 
8.4.0-beta.3 - 2023-03-09
- #1184 API Updates for beta branch
- Updated stable APIs to the latest version
 - Remove support for 
list_transactionsmethod on resourceTax.Transaction 
 
8.4.0-beta.2 - 2023-03-03
- #1183 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for new resources 
Issuing.CardBundleandIssuing.CardDesign - Add support for 
listandretrievemethods on resourceCardBundle - Add support for 
list,retrieve, andupdatemethods on resourceCardDesign 
 
8.4.0-beta.1 - 2023-02-23
- #1182 API Updates for beta branch
- Updated stable APIs to the latest version
 
 
8.3.0 - 2023-02-16
- #1175 API Updates
- Add support for 
refund_paymentmethod on resourceTerminal.Reader 
 - Add support for 
 
8.3.0-beta.1 - 2023-02-02
- #1174 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for new resource 
FinancialConnections.Transaction - Add support for 
listmethod on resourceTransaction 
 
8.2.0 - 2023-02-02
- #1173 API Updates
- Add support for 
resumemethod on resourceSubscription 
 - Add support for 
 - #1171 Remove unused 
partialparam frominitialize_from 
8.2.0-beta.3 - 2023-01-26
- #1172 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for 
list_transactionsmethod on resourceTax.Transaction 
 
8.2.0-beta.2 - 2023-01-19
- #1170 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for 
Tax.Settingsresource. 
 
8.2.0-beta.1 - 2023-01-12
- #1167 API Updates for beta branch
- Updated stable APIs to the latest version
 - Change 
quote.draft_quoteimplementation to from callingPOST /v1/quotes/{quote}/drafttoPOST /v1/quotes/{quote}/mark_draft - Add support for 
Tax::Registerresource 
 
8.1.0 - 2023-01-12
- #1162 Improve request events instrumentation
 
8.1.0-beta.4 - 2023-01-05
- #1164 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for 
mark_stale_quotemethod on resourceQuote 
 
8.1.0-beta.3 - 2022-12-22
- #1158 API Updates for beta branch
- Updated stable APIs to the latest version
 - Move 
TaxCalculationandTaxTransactiontoTax::CalculationandTax::Transaction. 
 
8.1.0-beta.2 - 2022-12-15
- #1156 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for new resources 
TaxCalculation, andTaxTransaction - Add support for 
createandlist_line_itemsmethods on resourceTaxCalculation - Add support for 
create_reversal,create, andretrievemethods on resourceTaxTransaction 
 - #1155 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for new resource 
QuoteLine. 
 
8.1.0-beta.1 - 2022-12-08
- #1153 API Updates for beta branch
- Updated stable APIs to the latest version
 
 - #1146 API Updates for beta branch
- Updated stable APIs to the latest version
 
 
8.0.0 - 2022-11-16
- #1144 Next major release changes
 
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-11-15.
"⚠️" symbol highlights breaking changes.
7.2.0-beta.5 - 2022-11-02
- #1139 API Updates for beta branch
- Updated beta APIs to the latest stable version
 
 - #1135 API Updates for beta branch
- Updated stable APIs to the latest version
 
 
7.2.0-beta.4 - 2022-10-07
- #999 DESCRIBE CHANGES HERE (try to use the same style, tense, etc. as the other entries)
 
7.2.0-beta.3 - 2022-09-26
- #1129 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add 
FinancingOffer,FinancingSummaryandFinancingTransactionresources. 
 
7.2.0-beta.2 - 2022-08-26
- #1127 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add support for the beta Gift Card API.
 
 
7.2.0-beta.1 - 2022-08-23
- #1122 API Updates for beta branch
- Updated stable APIs to the latest version
 Stripe-Versionbeta headers are not pinned by-default and need to be manually specified, please refer to beta SDKs README section
 
7.1.0 - 2022-08-19
- #1116 API Updates
- Add support for new resource 
CustomerCashBalanceTransaction 
 - Add support for new resource 
 - #1118 Update AllowedChars in rubocop config
 - #1117 Refresh rubocop config.
 - #1115 Add a support section to the readme
 
7.1.0-beta.2 - 2022-08-11
- #1113 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add 
refund_paymentmethod to Terminal resource 
 
7.1.0-beta.1 - 2022-08-03
- #1107 API Updates for beta branch
- Updated stable APIs to the latest version
 - Added the 
Orderresource support 
 
7.0.0 - 2022-08-02
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v7. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-08-01.
"⚠️" symbol highlights breaking changes.
- #1106 API Updates
 - #1092 API Updates
 - #1090 Use auto-generation for 
Invoicemethods - #1103 Next major release changes
 
6.6.0-beta.1 - 2022-07-22
- #1100 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add 
QuotePhaseresource 
 - #1097 API Updates for beta branch
- Updated stable APIs to the latest version
 - Add 
SubscriptionSchedule.amendmethod. 
 - #1093 API Updates for beta branch
- Include 
server_side_confirmation_beta=v1beta - Add 
secretKeyConfirmationtoPaymentIntent 
 - Include 
 - #1085 API Updates for beta branch
- Updated stable APIs to the latest version
 
 - #1075 Use the generated API version
 
6.5.0 - 2022-06-29
- #1084 API Updates
- Add support for 
deliver_card,fail_card,return_card, andship_cardtest helper methods on resourceIssuing.Card 
 - Add support for 
 - #1076 fix: Update logging to coerce ASCII-8BIT into UTF-8.
 
6.4.0 - 2022-06-17
- 
#1073 API Updates
- Add support for 
fund_cash_balancetest helper method on resourceCustomer 
 - Add support for 
 - 
#1074 Support updating pre-release versions
 - 
#1072 Trigger workflows on beta branches
 - 
#1071 Use request_stripe_object for all requests
 - 
#1070 API Updates
Switch from using meta-programing to generating explicit methods for custom methods.
 - 
#1069 chore: Stop special implementation of Account.persons method.
 
6.3.0 - 2022-06-08
- #1063 fix: Update cash balance methods to no longer require nested ID.
 
6.2.0 - 2022-05-23
- #1060 API Updates
- Add support for new resource 
Apps.Secret 
 - Add support for new resource 
 
6.1.0 - 2022-05-19
- #1057 API Updates
- Add support for new resources 
Treasury.CreditReversal,Treasury.DebitReversal,Treasury.FinancialAccountFeatures,Treasury.FinancialAccount,Treasury.FlowDetails,Treasury.InboundTransfer,Treasury.OutboundPayment,Treasury.OutboundTransfer,Treasury.ReceivedCredit,Treasury.ReceivedDebit,Treasury.TransactionEntry, andTreasury.Transaction - Add support for 
retrieve_payment_methodmethod on resourceCustomer - Add support for 
list_ownersandlistmethods on resourceFinancialConnections.Account 
 - Add support for new resources 
 
6.0.0 - 2022-05-09
- 
#1056 API Updates Major version release. The migration guide contains more information.
(⚠️ = breaking changes):
- ⚠️ Replace the legacy 
OrderAPI with the newOrderAPI.- New methods: 
cancel,list_line_items,reopen, andsubmit - Removed methods: 
payandreturn_order - Removed resources: 
OrderItemandOrderReturn 
 - New methods: 
 - ⚠️ Rename 
FinancialConnections::Account.refreshto `FinancialConnections::Account.refresh_account 
 - ⚠️ Replace the legacy 
 
5.55.0 - 2022-05-05
- #1055 API Updates
- Add support for new resources 
FinancialConnections.AccountOwner,FinancialConnections.AccountOwnership,FinancialConnections.Account, andFinancialConnections.Session 
 - Add support for new resources 
 
5.54.0 - 2022-05-03
- #1053 API Updates
- Add support for new resource 
CashBalance 
 - Add support for new resource 
 
5.53.0 - 2022-04-21
- #1050 API Updates
- Add support for 
expiretest helper method on resourceRefund 
 - Add support for 
 
5.52.0 - 2022-04-18
- #1046 #1047 API Updates
- Add support for new resources 
FundingInstructionsandTerminal.Configuration 
 - Add support for new resources 
 
5.51.0 - 2022-04-15
- #1046 This release was incomplete and was yanked from RubyGems immediately after it was published.
 
5.50.0 - 2022-04-13
- #1045 API Updates
- Add support for 
increment_authorizationmethod on resourcePaymentIntent 
 - Add support for 
 
5.49.0 - 2022-04-08
- #1043 API Updates
- Add support for 
apply_customer_balancemethod on resourcePaymentIntent 
 - Add support for 
 
5.48.0 - 2022-03-30
- #1041 API Updates
- Add support for 
cancel_action,process_payment_intent,process_setup_intent, andset_reader_displaymethods on resourceTerminal.Reader 
 - Add support for 
 
5.47.0 - 2022-03-29
- 
#1040 API Updates
- Add support for Search API
- Add support for 
searchmethod on resourcesCharge,Customer,Invoice,PaymentIntent,Price,Product, andSubscription 
 - Add support for 
 
 - Add support for Search API
 - 
#1034 Add supporting classes for test helper generation
 
5.46.0 - 2022-03-23
5.45.0 - 2022-03-01
- #1035 API Updates
- Add support for new resource 
TestHelpers.TestClock 
 - Add support for new resource 
 
5.44.0 - 2022-02-16
- #1032 API Updates
- Add support for 
verify_microdepositsmethod on resourcesPaymentIntentandSetupIntent 
 - Add support for 
 
5.43.0 - 2022-01-20
- #1031 API Updates
- Add support for new resource 
PaymentLink 
 - Add support for new resource 
 
5.42.0 - 2021-12-13
- #1022 Add connection manager logging and include object IDs in logging.
 
5.41.0 - 2021-11-16
- #1017 API Updates
- Add support for new resource 
ShippingRate 
 - Add support for new resource 
 
5.40.0 - 2021-11-11
- #1015 API Updates
- Add support for 
expiremethod on resourceCheckout.Session 
 - Add support for 
 - #1013 Add tests for child resources.
 - #1012 Add tests for namespaced resources.
 - #1011 codegen: 3 more files
 
5.39.0 - 2021-10-11
- #1010 API Updates
- Add support for 
list_payment_methodsmethod on resourceCustomer 
 - Add support for 
 
5.38.0 - 2021-08-10
- #993 Add 
request_idto RequestEndEvent - #991 Codegen more files
 - #989 Remove unused API error types from docs.
 
5.37.0 - 2021-07-14
- #988 API Updates
- Add support for 
list_computed_upfront_line_itemsmethod on resourceQuote 
 - Add support for 
 
5.36.0 - 2021-07-09
- #987 Add support for 
QuoteAPI 
5.35.0 - 2021-06-30
- #985 Update normalize_opts to use dup instead of clone.
 - #982 Deprecate travis
 - #983 Add support for making a request and receiving the response as a stream.
 
5.34.0 - 2021-06-04
- #981 API Updates
- Add support for 
TaxCodeAPI. 
 - Add support for 
 
5.33.0 - 2021-05-19
- #979 Add support for the Identify VerificationSession and VerificationReport APIs
 
5.32.1 - 2021-04-05
- Correct use of regexp 
matchin gemspec for old versions of Ruby 
5.32.0 - 2021-04-05
- #973 Reduce packed gem size
 
5.31.0 - 2021-04-02
- #968 Allow StripeClient to be configured per instance
 - #971 On config change, only clear connection managers for changed config
 - #972 Rename 
Stripe.configurationtoStripe.config - #970 Reserve some critical field names when adding 
StripeObjectaccessors - #967 CI: github actions
 
5.30.0 - 2021-02-22
- #965 Add support for the Billing Portal Configuration API
 
5.29.1 - 2021-02-09
- #964 Fix return value of 
Customer#delete_discount 
5.29.0 - 2021-01-05
- #952 Allow client_id configuration on instance config
 
5.28.0 - 2020-10-14
- #950 Add configuration option for 
write_timeoutfor connections on Ruby 2.6+ 
5.27.0 - 2020-10-14
- #951 Add support for the Payout Reverse API
 
5.26.0 - 2020-09-29
- #949 Add support for the 
SetupAttemptresource and List API 
5.25.0 - 2020-09-02
- #944 Add support for the Issuing Dispute Submit API
 
5.24.0 - 2020-08-26
5.23.1 - 2020-08-05
- #936 Rename API resource's 
requestmethod 
5.23.0 - 2020-08-05
- #937 Add support for the 
PromotionCoderesource and APIs 
5.22.0 - 2020-05-11
- #918 Add support for the 
LineItemresource and APIs 
5.21.0 - 2020-04-29
- #917 Add support for the 
Priceresource and APIs 
5.20.0 - 2020-04-27
- #916 Add new 
.generate_headermethod for webhooks 
5.19.0 - 2020-04-24
- #915 Expose 
Stripe::Webhook.compute_signaturepublicly 
5.18.0 - 2020-04-22
- #911 Add support for 
BillingPortalnamespace andSessionresource and APIs 
5.17.0 - 2020-02-26
- #907 Add 
StripeError#idempotent_replayed? 
5.16.0 - 2020-02-26
5.15.0 - 2020-02-10
- #902 Add 
request_begininstrumentation callback 
5.14.0 - 2020-01-14
- #896 Add support for 
CreditNoteLineItem - #894 Clean up test output by capturing 
$stderrwhen we expect warnings - #892 Explicitly pass a parameter as hash to be more ruby 2.7 friendly
 - #893 Upgrade Rubocop to 0.79
 
5.13.0 - 2020-01-08
- #891 Fix most Ruby 2.7 warnings
 
5.12.1 - 2020-01-06
- #890 Override API key with 
client_secretinOAuth.token 
5.12.0 - 2020-01-02
- #889 Add support for retrieve source transaction API method
 
5.11.0 - 2019-11-26
- #885 Add support for 
CreditNotepreview 
5.10.0 - 2019-11-08
- #882 Add list_usage_record_summaries and list_source_transactions
 
5.9.0 - 2019-11-07
- #870 Add request instrumentation callback (see 
README.mdfor usage example) 
5.8.0 - 2019-11-05
- #879 Add support for 
Mandate - #876 Add additional per-request configuration documentation
 - #874 Raise an error when requests params are invalid
 - #873 Contributor Covenant
 
5.7.1 - 2019-10-15
- #869 Fixes the misnamed 
connection_base=setter to be namedconnect_base= 
5.7.0 - 2019-10-10
- #865 Support backwards pagination with list's 
#auto_paging_each 
5.6.0 - 2019-10-04
- #861 Nicer error when specifying non-nil non-string opt value
 
5.5.0 - 2019-10-03
- #859 User-friendly messages and retries for 
EOFError,Errno::ECONNRESET,Errno::ETIMEDOUT, andErrno::EHOSTUNREACHnetwork errors 
5.4.1 - 2019-10-01
- #858 Drop Timecop dependency
 
5.4.0 - 2019-10-01
- #857 Move to monotonic time for duration calculations
 
5.3.0 - 2019-10-01
- #853 Support 
Stripe-Should-Retryheader 
5.2.0 - 2019-09-19
- #851 Introduce system for garbage collecting connection managers
 
5.1.1 - 2019-09-04
- #845 Transfer the request_id from the http_headers to error.
 
5.1.0 - 2019-08-27
- #841 Retry requests on a 429 that's a lock timeout
 
5.0.1 - 2019-08-20
- #836 Increase connection keep alive timeout to 30 seconds
 
5.0.0 - 2019-08-20
Major version release. The migration guide contains a detailed list of backwards-incompatible changes with upgrade instructions.
Pull requests included in this release (cf. #815) (⚠️ = breaking changes):
- ⚠️ #813: Convert library to use built-in 
Net::HTTP - ⚠️ #816: Make 
codeargument inCardErrornamed instead of positional. - ⚠️ #817: Drop support for very old Ruby versions.
 - #818: Bump Rubocop to latest version
 - #819: Ruby minimum version increase followup
 - ⚠️ #820: Remove old deprecated methods
 - ⚠️ #823: Remove all alias for list methods
 - ⚠️ #826: Remove 
UsageRecord.createmethod - ⚠️ #827: Remove 
IssuerFraudRecord - #811: Add 
ErrorObjecttoStripeErrorexceptions - #828: Tweak retry logic to be a little more like stripe-node
 - #829: Reset connections when connection-changing configuration changes (optional)
 - #830: Fix inverted sign for 500 retries
 - ⚠️#831: Remove a few more very old deprecated methods
 - #832: Minor cleanup in 
StripeClient - #833: Do better bookkeeping when tracking state in 
Thread.current - #834: Add 
Invoice.list_upcoming_line_itemsmethod 
4.24.0 - 2019-08-12
- #825 Add 
SubscriptionItem.create_usage_recordmethod- This release also removed the 
SubscriptionSchedule.revisionsmethod. This should have been included in the previous release (4.23.0) 
 - This release also removed the 
 
4.23.0 - 2019-08-09
- #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 Unify request/response handling
 
4.22.0 - 2019-07-30
- #821 Listing 
BalanceTransactionobjects now uses/v1/balance_transactionsinstead of/v1/balance/history 
4.21.3 - 2019-07-15
- #810 Better error message when passing non-string to custom method
 
4.21.2 - 2019-07-05
- #806 Revert back to 
initialize_fromfromUtil.convert_to_stripe_object 
4.21.1 - 2019-07-04
- #807 Add gem metadata
 
4.21.0 - 2019-06-28
- #803 Add support for the 
SetupIntentresource and APIs 
4.20.1 - 2019-06-28
- #805 Fix formatting in 
ConnectionFailederror message 
4.20.0 - 2019-06-24
- #800 Enable request latency telemetry by default
 
4.19.0 - 2019-06-17
- #770 Add support for 
CustomerBalanceTransactionresource and APIs 
4.18.1 - 2019-05-27
- #789 Allow 
Order#payto be called without arguments 
4.18.0 - 2019-05-23
- #783 Add support for 
radar.early_fraud_warningresource 
4.17.0 - 2019-05-14
- #779 Add support for the Capability resource and APIs
 
4.16.0 - 2019-04-24
- #760 Add support for the 
TaxRateresource and APIs 
4.15.0 - 2019-04-22
- #762 Add support for the 
TaxIdresource and APIs 
4.14.0 - 2019-04-18
- #758 Add support for the 
CreditNoteresource and APIs 
4.13.0 - 2019-04-16
- #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 Add 
.deleteclass method on deletable API resources - #754 Add class methods for all custom API requests (e.g. 
Charge.capture) 
4.11.0 - 2019-03-26
- #753 Add a global proxy configuration parameter
 
4.10.0 - 2019-03-18
- #745 Add support for the 
PaymentMethodresource and APIs - #747 Add support for retrieving a Checkout 
Session - #748 Add support for deleting a Terminal 
LocationandReader 
4.9.1 - 2019-03-18
- #750 Catch error and warn if unable to remove a method
 
4.9.0 - 2019-02-12
- #739 Add support for 
SubscriptionScheduleandSubscriptionScheduleRevision 
4.8.1 - 2019-02-11
- #743 Fix bug in file uploading introduced in #741
 
4.8.0 - 2019-02-03
- #741 Use 
FaradayStripeEncoderto encode all parameter styles 
4.7.1 - 2019-02-01
- #740 Fix query encoding for integer-indexed maps
 
4.7.0 - 2019-01-23
- #735 Rename 
CheckoutSessiontoSessionand move it under theCheckoutnamespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach. 
4.6.0 - 2019-01-21
- #736 Properly serialize 
individualonAccountobjects 
4.5.0 - 2019-01-02
- #719 Generate OAuth authorize URLs for Express accounts as well as standard
 
4.4.1 - 2018-12-31
- #718 Fix an error message typo
 
4.4.0 - 2018-12-21
- #716 Add support for the 
CheckoutSessionresource 
4.3.0 - 2018-12-10
- #711 Add support for account links
 
4.2.0 - 2018-11-28
- #705 Add support for the 
ReviewAPIs 
4.1.0 - 2018-11-27
- #695 Add support for 
ValueListandValueListItemfor Radar 
4.0.3 - 2018-11-19
- #703 Don't use 
Net::HTTP::Persistenton Windows where it's not well supported 
4.0.2 - 2018-11-16
- #701 Require minimum Faraday 0.13 for proper support of persistent connections
 
4.0.1 - 2018-11-15
- #699 Only send telemetry if 
Request-Idwas present in the response 
4.0.0 - 2018-11-15
- #698 Use persistent connections by default through 
Net::HTTP::Persistent - #698 Drop support for Ruby 2.0 (which we consider a breaking change here)
 
3.31.1 - 2018-11-12
- #697 Send telemetry in milliseconds specifically
 
3.31.0 - 2018-11-12
- #696 Add configurable telemetry to gather information on client-side request latency
 
3.30.0 - 2018-11-08
- #693 Add new API endpoints for the 
Invoiceresource. 
3.29.0 - 2018-10-30
3.28.0 - 2018-09-24
- #690 Add support for Stripe Terminal
 
3.27.0 - 2018-09-24
- #689 Rename 
FileUploadtoFile 
3.26.1 - 2018-09-14
- #688 Fix hash equality on 
StripeObject 
3.26.0 - 2018-09-05
- #681 Add support for reporting resources
 
3.25.0 - 2018-08-28
- #678 Allow payment intent 
#cancel,#capture, and#confirmto take their own parameters 
3.24.0 - 2018-08-27
- #675 Remove support for 
BitcoinReceiverwrite-actions 
3.23.0 - 2018-08-23
- #676 Add support for usage record summaries
 
3.22.0 - 2018-08-15
- #674 Use integer-indexed encoding for all arrays
 
3.21.0 - 2018-08-03
- #671 Add cancel support for topups
 
3.20.0 - 2018-08-03
- #669 Add support for file links
 
3.19.0 - 2018-07-27
- #666 Add support for scheduled query runs (
Stripe::Sigma::ScheduledQueryRun) for Sigma 
3.18.0 - 2018-07-26
- #665 Add support for Stripe Issuing
 
3.17.2 - 2018-07-19
- #664 Don't colorize log output being sent to a configured logger
 
3.17.1 - 2018-07-19
- #663 Internal improvements to 
ApiResource.class_url 
3.17.0 - 2018-06-28
- #658 Add support for 
partner_idfromStripe.set_app_info 
3.16.0 - 2018-06-28
- #657 Add support for payment intents
 
3.15.0 - 2018-05-10
- #649 Freeze all string literals
 
3.14.0 - 2018-05-09
- #645 Add support for issuer fraud records
 
3.13.1 - 2018-05-07
- #647 Merge query parameters coming from path with 
paramsargument 
3.13.0 - 2018-04-11
- #498 Add support for flexible billing primitives
 
3.12.1 - 2018-04-05
- #636 Fix a warning for uninitialized instance variable 
@additive_params 
3.12.0 - 2018-04-05
- #632 Introduce 
additive_object_paramso that non-metadatasubobjects don't zero their keys as they're being replaced 
3.11.0 - 2018-02-26
- #628 Add support for 
codeattribute on all Stripe exceptions 
3.10.0 - 2018-02-21
- #627 Add support for topups
 
3.9.2 - 2018-02-12
- #625 Skip calling 
to_hashfornil 
3.9.1 - 2017-12-15
- #616 Support all file-like objects for uploads with duck typed checks on 
pathandread(we previously whitelisted only certain classes) 
3.9.0 - 2017-12-08
- #613 Introduce new 
IdempotencyErrortype for idempotency-specific failures 
3.8.2 - 2017-12-07
- #612 Fix integer-indexed array encoding when sent as query parameter (subscription items can now be used when fetching an upcoming invoice)
 
3.8.1 - 2017-12-06
- #611 Support 
Tempfile(as well asFile) in file uploads 
3.8.0 - 2017-10-31
- #606 Support for exchange rates APIs
 
3.7.0 - 2017-10-26
- #603 Support for listing source transactions
 
3.6.0 - 2017-10-17
- #597 Add static methods to manipulate resources from parent
Accountgains methods for external accounts and login links (e.g..create_account,create_login_link)ApplicationFeegains methods for refundsCustomergains methods for sourcesTransfergains methods for reversals
 
3.5.3 - 2017-10-16
- #594 Make sure that 
StripeObject's#deep_copymaintains original class - #595 Allow 
Object#methodto be called onStripeObjecteven if it conflicts with an accessor - #596 Encode arrays as integer-indexed hashes where appropriate
 - #598 Don't persist 
idempotency_keyopt between requests 
3.5.2 - 2017-10-13
- #592 Bring back 
Marshal.dump/loadsupport with custom marshal encoder/decoder 
3.5.1 - 2017-10-12
- #591 Use thread-local 
StripeClientinstances for thread safety 
3.5.0 - 2017-10-11
- #589 Rename source 
deletetodetach(and deprecate the former) 
3.4.1 - 2017-10-05
- #586 Log query strings as well as form bodies with STRIPE_LOG
 - #588 Require minimum Faraday 0.10 for bug fix in parameter encoding
 
3.4.0 - 2017-09-20
- Mark legacy Bitcoin API as deprecated, and remove corresponding tests
 - Mark recipients API as deprecated, and remove recipient card tests
 
3.3.2 - 2017-09-20
- Correct minimum required Ruby version in gemspec (it's 2.0.0)
 
3.3.1 - 2017-08-18
- Only parse webhook payload after verification to decrease likelihood of attack
 
3.3.0 - 2017-08-11
- Add support for standard library logger interface with 
Stripe.logger - Error logs now go to stderr if using 
Stripe.log_level/STRIPE_LOG Stripe.log_level/STRIPE_LOGnow supportStipe::LEVEL_ERROR
3.2.0 - 2017-08-03
- Add logging for request retry account and 
Stripe-Accountheader 
3.1.0 - 2017-08-03
- Implement request logging with 
Stripe.log_levelandSTRIPE_LOG 
3.0.3 - 2017-07-28
- Revert 
nilto empty string coercion from 3.0.2 - Handle 
invalid_clientOAuth error code - Improve safety of error handling logic safer for unrecognized OAuth error codes
 
3.0.2 - 2017-07-12
Important: This version is non-functional and has been yanked in favor of 3.0.3.
- Convert 
nilto empty string when serializing parameters (instead of opaquely dropping it) -- NOTE: this change has since been reverted 
3.0.1 - 2017-07-11
- Properties set with an API resource will now serialize that resource's ID if possible
 - API resources will throw an ArgumentError on save if a property has been with an API resource that cannot be serialized
 
3.0.0 - 2017-06-27
#payon invoice now takes params as well as opts
2.12.0 - 2017-06-20
- Add support for ephemeral keys
 
2.11.0 - 2017-05-26
- Warn when keys that look like opts are included as parameters
 
2.10.0 - 2017-05-25
- Add support for account login links
 
2.9.0 - 2017-05-18
- Support for OAuth operations in 
Stripe::OAuth 
2.8.0 - 2017-04-28
- Support for checking webhook signatures
 
2.7.0 - 2017-04-26
- Add model 
InvoiceLineItem 
2.6.0 - 2017-04-26
- Add 
OBJECT_NAMEconstants to all API resources 
2.5.0 - 2017-04-24
- Make 
optsargument inUtil.convert_to_stripe_objectoptional 
2.4.0 - 2017-04-18
- Add 
Stripe.set_app_infofor use by plugin creators 
2.3.0 - 2017-04-14
- Add question mark accessor when assigning boolean value to undefined field
 
2.2.1 - 2017-04-07
- Declare minimum required Faraday as 0.9
 
2.2.0 - 2017-04-06
- Add support for payouts and recipient transfers
 
2.1.0 - 2017-03-17
- Support for detaching sources from customers
 
2.0.3 - 2017-03-16
- Fix marshalling of 
StripeObjectsthat have an embedded client 
2.0.2 - 2017-03-16
- Fix bad field reference when recovering from a JSON parsing problem
 
2.0.1 - 2017-02-22
- Fix multipart parameter encoding to repair broken file uploads
 
2.0.0 - 2017-02-14
- Drop support for Ruby 1.9
 - Allow HTTP client that makes Stripe calls to be configured via Faraday
 - Drop RestClient
 - Switch to OpenAPI 2.0 spec and generated fixtures in test suite
 - Switch to Webmock in test suite
 
1.58.0 - 2017-01-19
- Remove erroneously added list methods for 
Sourcemodel 
1.57.1 - 2016-11-28
- Disallow sending protected fields along with API resource 
.update 
1.57.0 - 2016-11-21
- Add retrieve method for 3-D Secure resources
 
1.56.2 - 2016-11-17
- Improve 
StripeObject's#to_sto better handle how embedded objects are displayed 
1.56.1 - 2016-11-09
- Fix (fairly serious) memory like in 
StripeObject 
1.56.0 - 2016-10-24
- Add accessors for new fields added in 
#update_attributes - Handle multi-plan subscriptions through new subscription items
 - Handle 403 status codes from the API
 
1.55.1 - 2016-10-24
Identical to 1.56.0 above. I incorrectly cut a patch-level release.
1.55.0 - 2016-09-15
- Add support for Apple Pay domains
 
1.54.0 - 2016-09-01
- Whitelist errors that should be retried; scope to known socket and HTTP errors
 
1.53.0 - 2016-08-31
- Relax version constraint on rest-client (and by extension mime-types) for users on Ruby 2+
 
1.52.0 - 2016-08-30
- Make sure 
Subscription'ssourceis saved with its parent 
1.51.1 - 2016-08-30
- Make sure 
Account'sexternal_accountis saved with its parent 
1.51.0 - 2016-08-26
- Error when an array of maps is detected that cannot be accurately encoded
 - Start using strings for header names instead of symbols for better clarity
 
1.50.1 - 2016-08-25
- Fix encoding of arrays of maps where maps unequal sets of keys
 
1.50.0 - 2016-08-15
- Allow sources to be created
 
1.49.0 - 2016-07-28
- Add top-level 
Sourcemodel 
1.48.0 - 2016-07-12
- Add 
ThreeDSecuremodel for 3-D secure payments 
1.47.0 - 2016-07-11
- Allow rest-client version 2.0+ to be used with the gem
 
1.46.0 - 2016-07-07
- Allow retry when a 409 conflict is encountered
 
1.45.0 - 2016-07-07
- Do not send subresources when updating except when explicitly told to do so (see #433)
 
1.44.0 - 2016-06-29
- Add 
updateclass method to all resources that can be updated 
1.43.1 - 2016-06-17
- Fix type of resource returned from 
Order#return_order 
1.43.0 - 2016-05-20
- Allow Relay orders to be returned and add associated types
 - Support Alipay account retrieval and deletion
 
1.42.0 - 2016-05-04
- Add support for the new /v1/subscriptions endpoint (retrieve, list, create, update, and delete)
 
1.41.0 - 2016-04-13
- Add global 
stripe_accountoption that adds aStripe-Accountheader to all requests 
1.40.0 - 2016-04-06
- Fix bug that omitted subresources from serialization
 
1.39.0 - 2016-03-31
- Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
 
1.38.0 - 2016-03-18
- Allow 
optsto be passed to an API resource's#savemethod 
1.37.0 - 2016-03-14
- Add 
Account#rejectto support the new API feature 
1.36.2 - 2016-03-14
- Fix reference to non-existent 
#urlinListObject 
1.36.1 - 2016-03-04
- Fix serialization when subhash given to 
#saveor#update_attributes 
1.36.0 - 2016-02-08
- Add 
CountrySpecmodel for looking up country payment information 
1.35.1 - 2016-02-03
- Add compatibility layer for old API versions on 
Charge#refund 
1.35.0 - 2016-02-01
- Allow CA cert bundle location to be configured
 - Updated bundled CA certs
 
1.34.0 - 2016-01-25
- Add support for deleting products and SKUs
 
1.33.1 - 2016-01-21
- Pass through arguments of 
Charge#refund 
1.33.0 - 2016-01-19
- Re-implement 
Charge#refundhelper to use the modern endpoint suggested by docs 
1.32.1 - 2016-01-07
- Fix bug where ivar left uninitialized in StripeObject could error on serialization
 - Fix bug where a nil customer from API could error Bitcoin model on refresh
 
1.32.0 - 2016-01-05
- Add configuration to optionally retry network failures
 - Use modern API endpoint for producing application fee refunds
 
1.31.0 - 2015-10-29
- Add BankAccount#verify convenience method
 
1.30.3 - 2015-10-28
- Fix bug where arrays that were not 
additional_ownerswere not properly encoded for requests 
1.30.2 - 2015-10-12
- Fix bug where 
optsdidn't properly propagate to descendantStripeObjects 
1.30.1 - 2015-10-10
- Fix bug that prevent lists of hashes from being URI-encoded properly
 - Fix bug where filter conditions were not making it past the first instantiated 
ListObject 
1.30.0 - 2015-10-09
- Add 
StripeObject#deleted?for a reliable way to check whether an object is alive - Deprecate 
StripeObject#refresh_from - New parameter encoding scheme that doesn't use 
URI.escape 
1.29.1 - 2015-10-06
- Fix bug where ampersands were not being properly encoded
 
1.29.0 - 2015-10-05
- Add pagination helpers 
#auto_paging_each,#previous_page, and#next_page 
1.28.1 - 2015-10-05
- Fix URI being referenced by file upload resources
 
1.28.0 - 2015-10-05
- Make StripeObject's #save "upsert"-like; creates an object if new
 - Add #update_attributes to StripeObject for safe mass assignment
 - Properly mass assign attributes on calls to #save
 - Add question mark helpers for boolean fields (e.g. #paid? as well as old #paid)
 - Fix a bug that broke the API for StripeObject initialization
 - Remove use of deprecated URI.escape
 
1.27.2 - 2015-09-25
- Correct the URLs used to fetch Bitcoin transactions.
 
1.27.1 - 2015-09-20
- Use hash rockets for backwards compatibility.
 
1.27.0 - 2015-09-14
- Add Orders, Products, and SKUs for Relay
 
1.26.0 - 2015-09-11
- Add support for 429 Rate Limited response
 
1.25.0 - 2015-08-17
- Added support for refund listing and retrieval without an associated charge
 
1.24.0 - 2015-08-03
- Added support for deleting managed accounts
 - Added support for dispute listing and retrieval
 - Bugfix: token objects now are the correct class
 
1.23.0 - 2015-07-06
- Added request IDs and HTTP headers to errors
 
1.22.0 - 2015-06-10
- Added support for bank accounts and debit cards in managed accounts (via the 
external_accountsparam) 
1.21.0 - 2015-04-14
- Remove TLS cert revocation check (all pre-heartbleed certs have expired)
 - Bugfix: don't unset keys when they don't exist on StripeObject
 
1.20.4 - 2015-03-26
- Raise an error when explicitly passing nil as the API key on resource methods
 - Fix error when passing an API key to Balance.retrieve (github issue #232)
 
1.20.3 - 2015-03-13
- Fixed error when updating certain resources (github issue #224)
 
1.20.2 - 2015-03-10
- Added support for updating nested hashes besides 
metadata(which was already supported) - Fixed bug in balance retrieval
 
1.20.1 - 2015-02-26
- Updated Card to point to customer sources endpoint when customer property is set
 
1.20.0 - 2015-02-19
- Added Update & Delete operations to Bitcoin Receivers
 
1.19.1 - 2015-02-18
- Fixed fetching upcoming invoice/paying invoice methods
 
1.19.0 - 2015-02-15
- Support for new Transfers /reversals endpoint
 - Account retrieval now optionally accepts an account ID
 - Better support for passing custom headers, like Stripe-Account, through requests
 
1.18.0 - 2015-01-21
- 1 major enhancement:
- Added support for making bitcoin charges through BitcoinReceiver source object
 
 
1.17.3 - 2015-01-12
- 1 bugfix:
- Fixed API key propagation for ApplicationFee#refund
 
 
1.17.2 - 2015-01-08
- 1 bugfix:
- Fixed API key propagation for child resources
 
 
1.17.1 - 2015-01-07
- 2 minor enhacements:
- Fixed dependencies for Ruby versions less than 1.9.3
 - Added deauthorize method to Account object
 
 
1.17.0 - 2014-12-15
- 1 major enhacement:
- File uploads resource was added (for uploading pdf or image documents for disputes)
 
 
1.16.1 - 2014-12-19
- 2 minor enhancements:
- Ability to send idempotent requests
 - Ability to specify stripe account as a header
 
 
1.16.0 - 2014-10-08
- 1 minor enhacement:
- Coupons now support update operations - useful for manipulating metadata
 
 
1.15.0 - 2014-07-26
- 1 major enhacement:
- Application Fee refunds now a list instead of array
 
 
1.14.0 - 2014-06-17
- 1 major enhancement:
- Add metadata for refunds and disputes
 
 
1.13.0 - 2014-05-28
- 1 major enhancement:
- Support for canceling transfers
 
 
1.12.0 - 2014-05-21
- 1 major enhancement:
- Support for cards for recipients
 
 
1.11.0 - 2014-04-09
- 2 minor enhancements:
- Update included ca bundles
 - Implement certificate blacklisting
 
 
1.10.2 - 2014-02-18
- 1 minor enhancement:
- Add create_subscription on Customer resources, so you can create subscriptions without needing to retrieve the customer first (github issue #120)
 
 
1.10.1 - 2014-02-03
- 1 bugfix:
- Fix marshaling of StripeObjects
 
 
1.10.0 - 2014-01-29
- 
2 major enhancements
- Support for multiple subscriptions per customer
 - Testing ruby 2.1.0
 
 - 
2 minor enhancements
- Replace multi_json with json
 - Allow #save to take opts (for :expand)
 
 - 
1 bugfix
- Fix #try and #respond_to? on StripeObjects
 
 
1.9.9 - 2013-12-02
- 1 major enhancement
- Add ApplicationFee resource
 
 
1.8.9 - 2013-11-14
- 2 bugfixes:
- Fix gemspec dependencies so the gem doesn't break for Ruby 1.8 users
 - Fix api_resource_test to not use returns as a way of testing rescue behavior
 
 
1.8.8 - 2013-10-3
- 1 major enhancement
- Add support for metadata on resources
 
 
1.8.7 - 2013-08-18
- 1 minor enhancement
- Add support for closing disputes.
 
 
1.8.6 - 2013-08-13
- 1 major enhancement
- Add Balance and BalanceTransaction resources
 
 
1.8.5 - 2013-08-12
- 1 major enhancement
- Add support for unsetting attributes by setting to nil. This permits unsetting email and description on customers and description on charges. Setting properties to a blank string is now an error.
 - Attempting to set an object's id is now an error
 
 
1.8.4 - 2013-07-11
- 1 major enhancement
- Add support for new cards API (Stripe API version - 2013-07-05)
 
 
1.8.3 - 2013-05-06
- 1 bugfix:
- Fix handling of per-call API keys (github issue #67)
 
 
1.8.2 - 2013-05-01
- 
3 minor enhancements:
- Use to_sym instead of type checking for minor performance improvement (github issue #59)
 - Handle low-memory situations without throwing an exception (github issue #61)
 - Add an Customer#upcoming_invoice convenience method (github issue #65)
 
 - 
1 bugfix:
- Allow updating resources without first retrieving them (github issue #60)
 
 
1.8.1 - 2013-04-19
- 1 minor enhancement:
- Add support for specifying an API key when retrieving an upcoming invoice
 
 
1.8.0 - 2013-04-11
- 1 major enhancement:
- Add new Recipient resource
 - Allow Transfers to be createable
 
 
1.7.11 - 2013-02-21
- 1 minor enhancement
- Add 'id' to the list of permanent attributes
 
 
1.7.10 - 2013-02-01
- 1 major enhancement
- Add support for passing options when retrieving Stripe objects e.g., Stripe::Charge.retrieve({id:"foo", expand:["customer"]}) Stripe::Charge("foo") is still supported as well
 
 
1.7.9 - 2013-01-15
- 1 major enhancement
- Add support for setting a Stripe API version override.
 
 
1.7.8 - 2012-11-21
- 1 bugfix
- Relax the version constraint on multi_json (github issue #44)
 
 
1.7.7 - 2012-11-07
- 
1 minor enhancement:
- Add support for updating charge disputes
 
 - 
1 bugfix
- Fix Account API resource bug
 
 
1.7.6 - 2012-10-30
- 1 major enhancement
- Add support for creating invoices
 
 
1.7.5 - 2012-10-25
- 1 major enhancement
- Add support for new API lists
 
 
1.7.4 - 2012-10-08
- 1 bugfix
- Fix bug introduced in 1.7.3 calling API methods that take no arguments, like Stripe::Invoice#pay (github issue #42)
 
 
1.7.3 - 2012-09-14
- 2 bugfixes
- Make sure that both keys and values of GET params are URL-encoded. NOTE: If you were previously URL-encoding values yourself, you may need to adjust your code.
 - URL-encode POST params directly, instead of allowing rest-client to do it to work around an unfortunate interaction with the hashery gem (github issue #38)
 
 
1.7.2 - 2012-08-31
- 1 major enhancement
- Add support for new pay and update methods for Invoice objects
 
 
1.7.1 - 2012-08-15
- 1 major enhancement
- Add new Account API resource
 
 
1.7.0 - 2012-05-17
- 
3 major enhancements:
- Switch from vendored stripe-json to multi_json for all JSON parsing and rendering. This should not impact programmatic usage of the library, but may cause small rendering differences from, e.g., StripeObject#inspect (github issue #22)
 - Add new delete_discount method to Customer objects
 - Add new Transfer API resource
 
 - 
2 minor enhancements:
- Switch from HTTP Basic auth to Bearer auth (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
 - Numerous test suite improvements
 
 
1.6.3 - 2012-03-22
- 1 bugfix:
- Encode GET query strings ourselves instead of using rest-client to work around a bug
 
 
1.6.2 - 2012-02-24
- 1 bugfix:
- Correct argument handling in StripeObject#as_json
 
 
1.6.1 - 2012-02-22
- 1 bugfix:
- Fix StripeObject#inspect when ActiveSupport 3.0 is loaded
 
 
1.6.0 - 2012-02-01
- A whole bunch of releases between 1.5.0 and 1.6.0, but few changes, mainly the addition of plans, coupons, events, and tokens
 - 1.6.0 also contains a new inspect/to_string implementation
 
1.5.0 - 2011-05-09
- 1 major enhancement:
- Update for new RESTful API
 
 
1.3.4 - 2011-01-07
- 1 major enhancement:
- Rename to Stripe
 
 
1.2 - 2010-06-06
- 1 major enhancement:
- Support for the set_customer_subscription and delete_customer API methods
 
 
1.1 - 2010-03-14
- 1 major enhancement:
- Support for recurring billing
 
 
1.0 - 2010-01-05
- 1 major enhancement:
- Initial release