v17.0.0

• #2192 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 due to changes in the Stripe API

  • Rename usage_threshold_config to usage_threshold on Billing.AlertCreateParams and Billing.Alert
  • Remove support for filter on Billing.AlertCreateParams and Billing.Alert. Use the filters on the usage_threshold instead
  • Remove support for customer_consent_collected on Terminal.ReaderProcessSetupIntentParams.

  ⚠️ Other Breaking changes in the SDK

  • Adjusted default values around reties for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
    • max retries: 1 -> 2
    • max timeout (seconds): 2 -> 5

  Additions

  • Add support for custom_unit_amount on ProductCreateParams.default_price_data
  • Add support for allow_redisplay on Terminal.ReaderProcessPaymentIntentParams.process_config and Terminal.ReaderProcessSetupIntentParams
  • Add support for new value international_transaction on enum Treasury.ReceivedCredit.failure_code
  • Add support for new value 2024-09-30.acacia on enum WebhookEndpointCreateParams.api_version
  • Add support for new Usage Billing APIs Billing.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events in the v2 namespace
  • Add method parseThinEvent() on the Stripe class to parse thin events.
  • Add method rawRequest() on the Stripe class that takes a HTTP method type, url and relevant parameters to make requests to the Stripe API that are not yet supported in the SDK.

  Changes

  • Change BillingPortal.ConfigurationCreateParams.features.subscription_update.default_allowed_updates and BillingPortal.ConfigurationCreateParams.features.subscription_update.products to be optional

See the changelog for more details.

v16.13.0-beta.1

• #2178 Update generated code for beta
  • Remove support for resource QuotePhase
  • Remove support for list_line_items and retrieve methods on resource QuotePhase
  • Add support for send_money and transfer_balance on AccountSessionCreateParams.components.financial_account.features
  • Add support for new value rechnung on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]
  • Change Quote.subscription_data_overrides[].end_behavior to be optional

See the changelog for more details.

v16.12.0

• #2177 Update generated code
  • Add support for new value international_transaction on enum Treasury.ReceivedDebit.failure_code
• #2175 Update generated code
  • Add support for new value verification_supportability on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].code
  • Add support for new value terminal_reader_invalid_location_for_activation on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
  • Add support for payer_details on Charge.payment_method_details.klarna
  • Add support for amazon_pay on Dispute.payment_method_details
  • Add support for new value amazon_pay on enum Dispute.payment_method_details.type
  • Add support for automatically_finalizes_at on Invoice
  • Add support for state_sales_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.us

See the changelog for more details.

v16.12.0-beta.1

• #2170 Update generated code for beta
  • Add support for new resources Issuing.DisputeSettlementDetail and Issuing.Settlement
  • Add support for list and retrieve methods on resource DisputeSettlementDetail
  • Remove support for list method on resource QuotePhase
  • Add support for new value rechnung on enum Checkout.SessionCreateParams.payment_method_types[]
  • Add support for new values issuing_dispute_settlement_detail.created, issuing_dispute_settlement_detail.updated, issuing_settlement.created, and issuing_settlement.updated on enum Event.type
  • Add support for settlement on Issuing.TransactionListParams and Issuing.Transaction
  • Add support for new values issuing_dispute_settlement_detail.created, issuing_dispute_settlement_detail.updated, issuing_settlement.created, and issuing_settlement.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]

See the changelog for more details.

v16.11.0

• #2171 Update generated code
  • Add support for new resource InvoiceRenderingTemplate
  • Add support for archive, list, retrieve, and unarchive methods on resource InvoiceRenderingTemplate
  • Add support for required on Checkout.Session.tax_id_collection, Checkout.SessionCreateParams.tax_id_collection, PaymentLink.tax_id_collection, PaymentLinkCreateParams.tax_id_collection, and PaymentLinkUpdateParams.tax_id_collection
  • Add support for template on Customer.invoice_settings.rendering_options, CustomerCreateParams.invoice_settings.rendering_options, CustomerUpdateParams.invoice_settings.rendering_options, Invoice.rendering, InvoiceCreateParams.rendering, and InvoiceUpdateParams.rendering
  • Add support for template_version on Invoice.rendering, InvoiceCreateParams.rendering, and InvoiceUpdateParams.rendering
  • Add support for new value submitted on enum Issuing.Card.shipping.status
  • Change TestHelpers.TestClock.status_details to be required
• #2172 Null out empty data sent to GET/DELETE APIs

See the changelog for more details.

v16.11.0-beta.1

• #2162 Update generated code for beta
  • Add support for new resources Billing.MeterErrorReport and Terminal.ReaderCollectedData
  • Add support for retrieve method on resource ReaderCollectedData
  • Add support for recipients on AccountSessionCreateParams.components
  • Add support for new value terminal_reader_collected_data_invalid on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.code
  • Add support for new value mb_way on enum Checkout.SessionCreateParams.payment_method_types[]
  • Add support for business_name, email, phone, and tax_ids on Checkout.Session.collected_information
  • Add support for new value billing.meter_error_report.triggered on enum Event.type
  • Add support for regulatory_reporting_file on Issuing.CreditUnderwritingRecordCorrectParams, Issuing.CreditUnderwritingRecordCreateFromProactiveReviewParams, Issuing.CreditUnderwritingRecordReportDecisionParams, and Issuing.CreditUnderwritingRecord
  • Add support for new value mb_way on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]
  • Remove support for rechnung on PaymentMethodUpdateParams
  • Add support for new value billing.meter_error_report.triggered on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]

See the changelog for more details.

v16.10.0

• #2158 Update generated code
  • Add support for subscription_item and subscription on Billing.AlertCreateParams.filter
  • Change Terminal.ReaderProcessSetupIntentParams.customer_consent_collected to be optional

See the changelog for more details.

v16.9.0

• #2163 Generate SDK for OpenAPI spec version 1230
  • Change AccountLinkCreateParams.collection_options.fields and LineItem.description to be optional
  • Add support for new value hr_oib on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • Add support for new value hr_oib on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.type
  • Add support for new value issuing_regulatory_reporting on enums File.purpose and FileListParams.purpose
  • Add support for new value issuing_regulatory_reporting on enum FileCreateParams.purpose
  • Change Issuing.Card.shipping.address_validation to be required
  • Add support for status_details on TestHelpers.TestClock

See the changelog for more details.

v16.9.0-beta.2

• #2159 Update generated code for beta
  • Add support for mb_way_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for mb_way on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for new value mb_way on enums ConfirmationTokenCreateParams.testHelpers.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • Add support for new value mb_way on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Add support for new value mb_way on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Remove support for values accepted, partner_rejected, and submitted from enum Dispute.evidence_details.enhanced_eligibility.visa_compelling_evidence_3.status
  • Add support for new value hr_oib on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
  • Add support for new value hr_oib on enum Order.tax_details.tax_ids[].type
  • Remove support for phases on QuoteCreateParams and QuoteUpdateParams
  • Remove support for from_schedule on QuoteCreateParams.subscription_data

See the changelog for more details.

v16.9.0-beta.1

• #2157 Update generated code for beta
  • Add support for capital_financing_application and capital_financing on AccountSessionCreateParams.components
  • Add support for permissions on Checkout.SessionCreateParams and Checkout.Session
  • Add support for collected_information on Checkout.SessionUpdateParams and Checkout.Session
  • Add support for shipping_options on Checkout.SessionUpdateParams

See the changelog for more details.