v27.2.0-beta.3

• #1897 Update generated code for beta
  • Add support for alma_payments, gopay_payments, kakao_pay_payments, kr_card_payments, naver_pay_payments, payco_payments, qris_payments, samsung_pay_payments, shopeepay_payments, treasury_evolve, treasury_fifth_third, and treasury_goldman_sachs on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for schedule_at_period_end on BillingPortal.Configuration.features.subscription_update, billingportal.ConfigurationCreateParams.features.subscription_update, and billingportal.ConfigurationUpdateParams.features.subscription_update
  • Change billingportal.ConfigurationCreateParams.business_profile to be optional
  • Add support for alma on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.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, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for gopay, qris, and shopeepay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.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 values alma, gopay, qris, and shopeepay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, PaymentMethodListParams.type, and checkout.SessionCreateParams.payment_method_types[]
  • Add support for new values alma, gopay, qris, and shopeepay on enums ConfirmationTokenCreateParams.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 auto on enum CustomerUpdateParams.tax.validate_location
  • Add support for metadata on forwarding.RequestCreateParams
  • Add support for new values jp_credit_transfer, kakao_pay, kr_card, naver_pay, and payco on enums InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]
  • Remove support for value expired from enum issuing.AuthorizationListParams.status
  • Add support for new values alma, gopay, qris, and shopeepay on enums PaymentLinkCreateParams.payment_method_types[] and PaymentLinkUpdateParams.payment_method_types[]
  • Add support for amazon_pay on PaymentMethodDomain
  • Add support for external_reference on Tax.Form.payee and tax.FormListParams.payee
  • Change type of Tax.Form.payee.type and tax.FormListParams.payee.type from literal('account') to enum('account'|'external_reference')
  • Add support for new values au_serr, ca_mrdp, eu_dac7, gb_mrdp, and nz_mrdp on enum tax.FormListParams.type
  • Add support for au_serr, ca_mrdp, eu_dac7, gb_mrdp, and nz_mrdp on Tax.Form
  • Add support for pln on Terminal.Configuration.tipping, terminal.ConfigurationCreateParams.tipping, and terminal.ConfigurationUpdateParams.tipping
  • Add support for bank on Treasury.FinancialAccountFeatures.financial_addresses.aba, treasury.FinancialAccountCreateParams.features.financial_addresses.aba, treasury.FinancialAccountUpdateFeaturesParams.financial_addresses.aba, and treasury.FinancialAccountUpdateParams.features.financial_addresses.aba

See the changelog for more details.

v27.1.1

• #1901 update object tags for meter-related classes

  • fixes a bug where the object property of the MeterEvent, MeterEventAdjustment, and MeterEventSession didn't match the server.

• #1898 Clean up examples

• #1894 Fixed example for raw request in readme file

See the changelog for more details.

v27.2.0-beta.2

• #1872 Update generated code for beta
  • Add support for submit_card test helper method on resource Issuing.Card
  • Add support for groups on AccountCreateParams, AccountUpdateParams, and Account
  • Add support for disable_stripe_user_authentication on AccountSession.components.account_management.features, AccountSession.components.account_onboarding.features, AccountSession.components.balances.features, AccountSession.components.notification_banner.features, AccountSession.components.payouts.features, AccountSessionCreateParams.components.account_management.features, AccountSessionCreateParams.components.account_onboarding.features, AccountSessionCreateParams.components.balances.features, AccountSessionCreateParams.components.financial_account.features, AccountSessionCreateParams.components.notification_banner.features, and AccountSessionCreateParams.components.payouts.features
  • Add support for card_spend_dispute_management and spend_control_management on AccountSessionCreateParams.components.issuing_cards_list.features
  • Add support for kakao_pay and kr_card on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, Mandate.payment_method_details, 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, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for naver_pay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.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, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for payco and samsung_pay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.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 values kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, PaymentMethodListParams.type, and checkout.SessionCreateParams.payment_method_types[]
  • Add support for new values kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums ConfirmationTokenCreateParams.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 values by_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat 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, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, TaxIdCreateParams.type, and tax.CalculationCreateParams.customer_details.tax_ids[].type
  • Add support for metadata on Forwarding.Request
  • Add support for new value retail_delivery_fee on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_type
  • Add support for new value expired on enum issuing.AuthorizationListParams.status
  • Add support for line_items on Order.payment.settings.payment_method_options.paypal, OrderCreateParams.payment.settings.payment_method_options.paypal, OrderUpdateParams.payment.settings.payment_method_options.paypal, PaymentIntent.payment_method_options.paypal, PaymentIntentConfirmParams.payment_method_options.paypal, PaymentIntentCreateParams.payment_method_options.paypal, and PaymentIntentUpdateParams.payment_method_options.paypal
  • Add support for flat_amount and rate_type on Tax.Calculation.tax_breakdown[].tax_rate_details and TaxRate
  • Add support for by, cr, ec, ma, md, rs, ru, tz, and uz on Tax.Registration.country_options and tax.RegistrationCreateParams.country_options
  • Add support for new value state_retail_delivery_fee on enum tax.RegistrationCreateParams.country_options.us.type
  • Add support for new value refund.failed on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]

See the changelog for more details.

v27.2.0-beta.1

• #1888 Update generated code
  • Add support for reporting_chart on AccountSessionCreateParams.components
  • Remove support for from_schedule on Quote.subscription_data
  • Add support for allow_redisplay on terminal.ReaderCollectPaymentMethodParams.collect_config

See the changelog for more details.

v27.1.0

• #1890 Update the class for ThinEvent to include livemode and reason
• #1891 Removed the class RequestSigningAuthenticator that was added in the previous release. Request Signing is not supported yet.
• #1889 Update generated code
  • Remove the support for resource Margin that was accidentally made public in the last release

See the changelog for more details.

v27.0.0

• #1880 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 Changelog and carefully review the API changes before upgrading.

  ⚠️ Breaking changes due to changes in the API

  • Rename usage_threshold_config to usage_threshold on Billing.Alert and billing.AlertCreateParams
  • Remove support for filter on Billing.Alert and billing.AlertCreateParams. 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 for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
    • max retries: 0 -> 2
  • Add method parseThinEvent() on the StripeClient class to parse thin events. Rename constructEvent() method on the same class to parseSnapshotEvent() to clearly distinguish between the two kinds of events.
  • Breaking changes to public classes that are meant for internal use only and should not affect you
    • Renamed setStripeResponseGetter on ApiResource to `setGlobalResponseGetter
    • Added another parameter to FormEncoder.flattenParams()
    • Removed the deprecated constructor overload on APIRequest
    • Removed GlobalStripeResponseGetterOptions.getAPiKey & StripeResponseGetterOptions.getApiKey. We now use a higher abstraction called Authenticator instead of passing around api keys
    • Changed return type of RequestOptions.RequestOptionsBuilder.getConnectTimeout from int to java.lang.Integer.
    • Removed the public constructor on StripeRequest in favor of a static StripeRequest.create()
    • The unused field partnerId on class Stripe is removed

  Additions

  • Add support for usage_threshold on Billing.Alert and billing.AlertCreateParams
  • 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 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 under the v2 namespace
  • Add methods rawRequest() on the StripeClient 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.

v26.13.0

• #1880 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 API

  • Rename usage_threshold_config to usage_threshold on Billing.Alert and billing.AlertCreateParams
  • Remove support for filter on Billing.Alert and billing.AlertCreateParams. 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 for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
    • max retries: 0 -> 2
  • Add method parseThinEvent() on the StripeClient class to parse thin events. Rename constructEvent() method on the same class to parseSnapshotEvent() to clearly distinguish between the two kinds of events.
  • Breaking changes to public classes that are meant for internal use only and should not affect you
    • Renamed setStripeResponseGetter on ApiResource to `setGlobalResponseGetter
    • Added another parameter to FormEncoder.flattenParams()
    • Removed the deprecated constructor overload on APIRequest
    • Removed GlobalStripeResponseGetterOptions.getAPiKey & StripeResponseGetterOptions.getApiKey. We now use a higher abstraction called Authenticator instead of passing around api keys
    • Changed return type of RequestOptions.RequestOptionsBuilder.getConnectTimeout from int to java.lang.Integer.
    • Removed the public constructor on StripeRequest in favor of a static StripeRequest.create()
    • The unused field partnerId on class Stripe is removed

  Additions

  • Add support for usage_threshold on Billing.Alert and billing.AlertCreateParams
  • 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 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 under the v2 namespace
  • Add methods rawRequest() on the StripeClient 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.

v26.13.0-beta.1

• #1870 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 PaymentLinkCreateParams.payment_method_types[] and PaymentLinkUpdateParams.payment_method_types[]

See the changelog for more details.

v26.12.0

• #1866 Update generated 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 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.

v26.12.0-beta.1

• #1862 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 settlement on Issuing.Transaction and issuing.TransactionListParams
  • 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.