EI

.github/workflows/ci.yml

@@ -18,12 +18,17 @@ on:
       - sdk-release/**
       - feature/**
 
+permissions: {}
+
 jobs:
   build:
     name: Build
 
     runs-on: "ubuntu-24.04"
 
+    permissions:
+      contents: read
+
     steps:
       - uses: extractions/setup-just@v2
       - uses: actions/checkout@master
@@ -49,19 +54,25 @@ jobs:
 
     runs-on: "ubuntu-24.04"
 
+    permissions:
+      contents: read
+
     strategy:
       fail-fast: false
       matrix:
         # We test Stripe SDK against Java LTS versions(8, 11, 17, 21) and currently supported non-LTS versions.
         # https://www.oracle.com/java/technologies/java-se-support-roadmap.html
+        # https://endoflife.date/oracle-jdk
         java-version:
+          # LTS versions
           - "1.8"
           - "11"
           - "17"
           - "21"
-          - "22"
-          - "23"
-          - "24"
+          - "25"
+          # non-LTS versions
+          # we should periodically add the latest non-LTS version here to test against
+          # as of 2025-09-29, the latest version of java (25) is LTS, so this section is empty. In March 2026, we'll add "26".
 
     steps:
       - uses: extractions/setup-just@v2
@@ -103,6 +114,8 @@ jobs:
       endsWith(github.actor, '-stripe')
     needs: [build, test]
     runs-on: "ubuntu-24.04"
+    permissions:
+      contents: read
     steps:
       - uses: actions/checkout@master
       - name: Setup Java
@@ -166,6 +179,9 @@ jobs:
   compat:
     runs-on: "ubuntu-24.04"
 
+    permissions:
+      contents: read
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v2

.github/workflows/rules.yml

@@ -7,6 +7,8 @@ on:
     types:
       - auto_merge_enabled
 
+permissions: {}
+
 jobs:
   require_merge_commit_on_merge_script_pr:
     name: Merge script PRs must create merge commits

CODEGEN_VERSION

@@ -0,0 +1 @@
+fdbf5e05015131c7993d2b4017103f0d94561b6a

Makefile

@@ -4,7 +4,8 @@
 update-version:
 	@echo "$(VERSION)" > VERSION
 	@perl -pi -e 's|badge/maven--central-v[.\d\-\w]+-blue|badge/maven--central-v$(VERSION)-blue|' README.md
-	@perl -pi -e 's|https:\/\/search\.maven\.org\/remotecontent\?filepath=com\/stripe\/stripe-java\/[.\d\-\w]+\/stripe-java-[.\d\-\w]+.jar|https://search.maven.org/remotecontent?filepath=com/stripe/stripe-java/$(VERSION)/stripe-java-$(VERSION).jar|' README.md
+	@perl -pi -e 's|https:\/\/repo1\.maven\.org\/maven2\/com\/stripe\/stripe-java\/[.\d\-\w]+\/stripe-java-[.\d\-\w]+.jar|https://repo1.maven.org/maven2/com/stripe/stripe-java/$(VERSION)/stripe-java-$(VERSION).jar|' README.md
+	@perl -pi -e 's|Current release version: [.\d\-\w]+|Current release version: $(VERSION)|' README.md
 	@perl -pi -e 's|implementation "com\.stripe:stripe-java:[.\d\-\w]+"|implementation "com.stripe:stripe-java:$(VERSION)"|' README.md
 	@perl -pi -e 's|<version>[.\d\-\w]+<\/version>|<version>$(VERSION)</version>|' README.md
 	@perl -pi -e 's|VERSION_NAME=[.\d\-\w]+|VERSION_NAME=$(VERSION)|' gradle.properties

OPENAPI_VERSION

@@ -1 +1 @@
-v1932
+v2160

README.md

@@ -1,6 +1,6 @@
 # Stripe Java client library
 
-[![Maven Central](https://img.shields.io/badge/maven--central-v29.5.0-blue)](https://mvnrepository.com/artifact/com.stripe/stripe-java)
+[![Maven Central](https://img.shields.io/badge/maven--central-v31.3.0-blue)](https://mvnrepository.com/artifact/com.stripe/stripe-java)
 [![JavaDoc](http://img.shields.io/badge/javadoc-reference-blue.svg)](https://stripe.dev/stripe-java)
 [![Build Status](https://github.com/stripe/stripe-java/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/stripe/stripe-java/actions?query=branch%3Amaster)
 
@@ -10,14 +10,20 @@ The official [Stripe][stripe] Java client library.
 
 ### Requirements
 
-- Java 1.8 or later
+We support LTS versions of the JDK. Currently, that's Java versions:
+
+- 8 (1.8)
+- 11
+- 17
+- 21
+- 25
 
 ### Gradle users
 
 Add this dependency to your project's build file:
 
 ```groovy
-implementation "com.stripe:stripe-java:29.5.0"
+implementation "com.stripe:stripe-java:31.3.0"
 ```
 
 ### Maven users
@@ -28,7 +34,7 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.stripe</groupId>
   <artifactId>stripe-java</artifactId>
-  <version>29.5.0</version>
+  <version>31.3.0</version>
 </dependency>
 ```
 
@@ -37,8 +43,8 @@ Add this dependency to your project's POM:
 If you are not using Gradle or Maven, you will need to manually install the following JARs:
 
 1. The Stripe JAR:
-   - Download the latest release version from [Maven Central](https://repo1.maven.org/maven2/com/stripe/stripe-java/29.0.0/stripe-java-29.0.0.jar)
-   - Current release version: 29.0.0
+   - Download the latest release version from [Maven Central](https://repo1.maven.org/maven2/com/stripe/stripe-java/31.3.0/stripe-java-31.3.0.jar)
+   - Current release version: 31.3.0
 
 2. Google Gson:
    - The Stripe JAR builds and tests with Gson version 2.10.1
@@ -93,7 +99,7 @@ public class StripeExample {
                 .build();
 
         try {
-            Customer customer = client.customers().create(params);
+            Customer customer = client.v1().customers().create(params);
             System.out.println(customer);
         } catch (StripeException e) {
             e.printStackTrace();
@@ -112,7 +118,7 @@ Once the legacy pattern is deprecated, new API endpoints will only be accessible
 
 ### Per-request Configuration
 
-All of the request methods accept an optional `RequestOptions` object. This is
+All the request methods accept an optional `RequestOptions` object. This is
 used if you want to set an [idempotency key][idempotency-keys], if you are
 using [Stripe Connect][connect-auth], or if you want to pass the secret API
 key on each method.
@@ -124,9 +130,9 @@ RequestOptions requestOptions = RequestOptions.builder()
     .setStripeAccount("acct_...")
     .build();
 
-client.customers().list(requestOptions);
+client.v1().customers().list(requestOptions);
 
-client.customers().retrieve("cus_123456789", requestOptions);
+client.v1().customers().retrieve("cus_123456789", requestOptions);
 ```
 
 ### Configuring automatic retries
@@ -147,7 +153,7 @@ Or on a finer grain level using `RequestOptions`:
 RequestOptions options = RequestOptions.builder()
     .setMaxNetworkRetries(2)
     .build();
-client.customers().create(params, options);
+client.v1().customers().create(params, options);
 ```
 
 [Idempotency keys][idempotency-keys] are added to requests to guarantee that
@@ -171,7 +177,7 @@ RequestOptions options = RequestOptions.builder()
     .setConnectTimeout(30 * 1000) // in milliseconds
     .setReadTimeout(80 * 1000)
     .build();
-client.customers().create(params, options);
+client.v1().customers().create(params, options);
 ```
 
 Please take care to set conservative read timeouts. Some API requests can take
@@ -207,15 +213,15 @@ CustomerCreateParams params =
     .putExtraParam("secret_parameter[secondary]", "secondary value")
     .build();
 
-client.customers().create(params);
+client.v1().customers().create(params);
 ```
 
 #### Properties
 
 To retrieve undocumented properties from Stripe using Java you can use an option in the library to return the raw JSON object and return the property as a native type. An example of this is shown below:
 
 ```java
-final Customer customer = client.customers().retrieve("cus_1234");
+final Customer customer = client.v1().customers().retrieve("cus_1234");
 Boolean featureEnabled =
   customer.getRawJsonObject()
     .getAsJsonPrimitive("secret_feature_enabled")
@@ -276,6 +282,8 @@ Stripe has features in the [private preview phase](https://docs.stripe.com/relea
 
 ### Custom requests
 
+> This feature is only available from version 27 of this SDK.
+
 If you would like to send a request to an undocumented API (for example you are in a private beta), or if you prefer to bypass the method definitions in the library and specify your request details directly, you can use the `rawRequest` method on `StripeClient`.
 
 ```java

VERSION

@@ -1 +1 @@
-29.5.0
+31.3.0

build.gradle

@@ -29,7 +29,7 @@ tasks.withType(JavaCompile) {
     }
 
     options.fork = true
-    options.forkOptions.jvmArgs += ['-Xms512M', '-Xmx1g']
+    options.forkOptions.jvmArgs += ['-Xms512M', '-Xmx4g']
 
     options.release = project.targetCompatibility.majorVersion as Integer
 
@@ -99,7 +99,8 @@ jar {
                    "Implementation-Version": VERSION_NAME,
                    "Implementation-Vendor": VENDOR_NAME,
                    "Bundle-SymbolicName": POM_ARTIFACT_ID,
-                   "Export-Package": "com.stripe.*")
+                   "Export-Package": "com.stripe.*",
+                   "Automatic-Module-Name": "stripe.java")
 
         archiveVersion = VERSION_NAME
     }

gradle.properties

@@ -1,5 +1,5 @@
 GROUP=com.stripe
-VERSION_NAME=29.5.0
+VERSION_NAME=31.3.0
 
 POM_URL=https://github.com/stripe/stripe-java
 POM_SCM_URL=git@github.com:stripe/stripe-java.git

justfile

@@ -28,7 +28,8 @@ format-check:
 update-version version:
     echo "{{ version }}" > VERSION
     perl -pi -e 's|badge/maven--central-v[.\d\-\w]+-blue|badge/maven--central-v{{ version }}-blue|' README.md
-    perl -pi -e 's|https:\/\/search\.maven\.org\/remotecontent\?filepath=com\/stripe\/stripe-java\/[.\d\-\w]+\/stripe-java-[.\d\-\w]+.jar|https://search.maven.org/remotecontent?filepath=com/stripe/stripe-java/{{ version }}/stripe-java-{{ version }}.jar|' README.md
+    perl -pi -e 's|https:\/\/repo1\.maven\.org\/maven2\/com\/stripe\/stripe-java\/[.\d\-\w]+\/stripe-java-[.\d\-\w]+.jar|https://repo1.maven.org/maven2/com/stripe/stripe-java/{{ version }}/stripe-java-{{ version }}.jar|' README.md
+    perl -pi -e 's|Current release version: [.\d\-\w]+|Current release version: {{ version }}|' README.md
     perl -pi -e 's|implementation "com\.stripe:stripe-java:[.\d\-\w]+"|implementation "com.stripe:stripe-java:{{ version }}"|' README.md
     perl -pi -e 's|<version>[.\d\-\w]+<\/version>|<version>{{ version }}</version>|' README.md
     perl -pi -e 's|VERSION_NAME=[.\d\-\w]+|VERSION_NAME={{ version }}|' gradle.properties

src/main/java/com/stripe/ApiVersion.java

@@ -2,6 +2,6 @@
 package com.stripe;
 
 final class ApiVersion {
-  public static final String CURRENT = "2025-08-27.basil";
-  public static final String CURRENT_MAJOR = "basil";
+  public static final String CURRENT = "2026-01-28.clover";
+  public static final String CURRENT_MAJOR = "clover";
 }

src/main/java/com/stripe/Stripe.java

@@ -14,7 +14,7 @@ public abstract class Stripe {
   public static final String LIVE_API_BASE = "https://api.stripe.com";
   public static final String UPLOAD_API_BASE = "https://files.stripe.com";
   public static final String METER_EVENTS_API_BASE = "https://meter-events.stripe.com";
-  public static final String VERSION = "29.5.0";
+  public static final String VERSION = "31.3.0";
 
   public static volatile String apiKey;
   public static volatile String clientId;