Stripe v22.0.0 Release Notes

Release Date: 2022-11-16 // 13 days ago
    • ๐Ÿš€ #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

    "โš ๏ธ" 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 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()

    โ†ช 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();
    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.

Previous changes from v21.15.0

    • โšก๏ธ #1472 API Updates
      • Add support for new values eg_tin, ph_tin, and tr_tin on enums CustomerCreateParams.tax_id_data[].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, and TaxIdCreateParams.type
      • Add support for reason_message on Issuing.Authorization.request_history[]