stripe/stripe-java v22.0.0

on GitHub

• #1471 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.

• ⚠️ Inline several "shared" classes for consistency (#1455)
• ⚠️ Removed LineItem.Product property that was released by mistake. (#1456)
• ⚠️ Removed Charges property on PaymentIntent and replace it with LatestCharge (#1473)
• ⚠️ Removed deprecated Amount, Currency, Description, Images, Name properties from SessionCreateParams.LineItem (#1473)
• ⚠️ Remove support for tos_shown_and_accepted on CheckoutSessionCreateParams.payment_method_options.paynow (#1473)
• ⚠️ Removed deprecated Sku resource (#1459)
• ⚠️ Removed deprecated EphemeralKey.associatedObjects field. (#1470)
• ⚠️ Removed RequestOptions.getStripeVersionOverride, RequestOptions.setStripeVersionOverride, and RequestOptions.clearStripeVersionOverride (#1464)

Use of setStripeVersionOverride is discouraged and can lead to unexpected errors during service calls because Java SDK class shapes are not guaranteed to match API responses on arbitrary versions.

If you were using these methods in conjunction with EphemeralKey resource prefer the EphemeralKeyCreateParamsBuilder.setStripeVersion.

EphemeralKeyCreateParams params = EphemeralKeyCreateParams.builder()
  .setStripeVersion("XXXX-YY-ZZ")
  .build();

If you have a use case that requires per-request version overrides, please file an issue on stripe-java repository to ensure we are aware and can add first-class support for it. In the meantime you can use unsafeSetStripeVersionOverride method as a workaround.

RequestOptions.RequestOptionsBuilder builder = RequestOptions.builder();
builder.setApiKey(...)
            .setClientId(...);

RequestOptionsBuilder.unsafeSetStripeVersionOverride(builder, "2022-11-15");

• #1474 API Updates
  • ⚠️ Remove support for tos_shown_and_accepted on CheckoutSessionCreateParams.payment_method_options.paynow. The property was mistakenly released and never worked.