Merge branch 'master' into jar/fix-javadocs-publishing

stripe · Mar 4, 2025 · 0de54d7 · 0de54d7
2 parents 0aadffd + 1cf6c5b
commit 0de54d7
Show file tree

Hide file tree

Showing 38 changed files with 1,736 additions and 194 deletions.
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -0,0 +1,2 @@
+# All files should be reviewed by a member of the SDKs team
+* @stripe/api-library-reviewers
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # Changelog
 
+## 28.4.0 - 2025-02-24
+* [#1943](https://github.com/stripe/stripe-java/pull/1943) Update generated code
+  * Add support for `prices` on `Billing.CreditGrant.applicability_config.scope`, `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, and `billing.CreditGrantCreateParams.applicability_config.scope`
+  * Change `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type` and `billing.CreditGrantCreateParams.applicability_config.scope.price_type` to be optional
+  * Add support for `priority` on `Billing.CreditGrant` and `billing.CreditGrantCreateParams`
+  * Add support for `target_date` on `Checkout.Session.payment_method_options.acss_debit`, `Checkout.Session.payment_method_options.au_becs_debit`, `Checkout.Session.payment_method_options.bacs_debit`, `Checkout.Session.payment_method_options.sepa_debit`, `Checkout.Session.payment_method_options.us_bank_account`, `PaymentIntent.payment_method_options.acss_debit`, `PaymentIntent.payment_method_options.au_becs_debit`, `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntent.payment_method_options.sepa_debit`, `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.acss_debit`, `PaymentIntentConfirmParams.payment_method_options.au_becs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.acss_debit`, `PaymentIntentCreateParams.payment_method_options.au_becs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.sepa_debit`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.acss_debit`, `PaymentIntentUpdateParams.payment_method_options.au_becs_debit`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `checkout.SessionCreateParams.payment_method_options.acss_debit`, `checkout.SessionCreateParams.payment_method_options.au_becs_debit`, `checkout.SessionCreateParams.payment_method_options.bacs_debit`, `checkout.SessionCreateParams.payment_method_options.sepa_debit`, and `checkout.SessionCreateParams.payment_method_options.us_bank_account`
+  * Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `checkout.SessionCreateParams.payment_method_options.card`
+  * Add support for `collected_information` on `Checkout.Session` and `checkout.SessionUpdateParams`
+  * Add support for `metadata` on `ProductCreateParams.default_price_data`
+  * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
+  * Add support for new value `2025-02-24.acacia` on enum `WebhookEndpointCreateParams.api_version`
+* [#1948](https://github.com/stripe/stripe-java/pull/1948) add codeowners file
+
+## 28.3.1 - 2025-02-07
+* [#1946](https://github.com/stripe/stripe-java/pull/1946) Ensure `getRawJsonObject` returns data for constructed webhooks
+
 ## 28.3.0 - 2025-01-27
 * [#1936](https://github.com/stripe/stripe-java/pull/1936) Update generated code
   * Add support for `close` method on resource `Treasury.FinancialAccount`

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION
@@ -1 +1 @@
-v1455
+v1505
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # Stripe Java client library
 
-[![Maven Central](https://img.shields.io/badge/maven--central-v28.3.0-blue)](https://mvnrepository.com/artifact/com.stripe/stripe-java)
+[![Maven Central](https://img.shields.io/badge/maven--central-v28.4.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)
 
@@ -17,7 +17,7 @@ The official [Stripe][stripe] Java client library.
 Add this dependency to your project's build file:
 
 ```groovy
-implementation "com.stripe:stripe-java:28.3.0"
+implementation "com.stripe:stripe-java:28.4.0"
 ```
 
 ### Maven users
@@ -28,15 +28,15 @@ Add this dependency to your project's POM:
 <dependency>
   <groupId>com.stripe</groupId>
   <artifactId>stripe-java</artifactId>
-  <version>28.3.0</version>
+  <version>28.4.0</version>
 </dependency>
 ```
 
 ### Others
 
 You'll need to manually install the following JARs:
 
-- [The Stripe JAR](https://search.maven.org/remotecontent?filepath=com/stripe/stripe-java/28.3.0/stripe-java-28.3.0.jar)
+- [The Stripe JAR](https://search.maven.org/remotecontent?filepath=com/stripe/stripe-java/28.4.0/stripe-java-28.4.0.jar)
 - [Google Gson][gson] from <https://repo1.maven.org/maven2/com/google/code/gson/gson/2.10.1/gson-2.10.1.jar>.
 
 ### [ProGuard][proguard]

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-28.3.0
+28.4.0
diff --git a/gradle.properties b/gradle.properties
@@ -1,5 +1,5 @@
 GROUP=com.stripe
-VERSION_NAME=28.3.0
+VERSION_NAME=28.4.0
 
 POM_URL=https://github.com/stripe/stripe-java
 POM_SCM_URL=[email protected]:stripe/stripe-java.git

diff --git a/src/main/java/com/stripe/ApiVersion.java b/src/main/java/com/stripe/ApiVersion.java
@@ -2,5 +2,5 @@
 package com.stripe;
 
 final class ApiVersion {
-  public static final String CURRENT = "2025-01-27.acacia";
+  public static final String CURRENT = "2025-02-24.acacia";
 }
diff --git a/src/main/java/com/stripe/Stripe.java b/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 = "28.3.0";
+  public static final String VERSION = "28.4.0";
 
   public static volatile String apiKey;
   public static volatile String clientId;

diff --git a/src/main/java/com/stripe/model/Balance.java b/src/main/java/com/stripe/model/Balance.java
@@ -166,15 +166,24 @@ public static class Available extends StripeObject {
     @Setter
     @EqualsAndHashCode(callSuper = false)
     public static class SourceTypes extends StripeObject {
-      /** Amount for bank account. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/ach-deprecated">legacy US ACH
+       * payments</a>.
+       */
       @SerializedName("bank_account")
       Long bankAccount;
 
-      /** Amount for card. */
+      /**
+       * Amount coming from most payment methods, including cards as well as <a
+       * href="https://docs.stripe.com/payments/bank-debits">non-legacy bank debits</a>.
+       */
       @SerializedName("card")
       Long card;
 
-      /** Amount for FPX. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/payments/fpx">FPX</a>, a Malaysian
+       * payment method.
+       */
       @SerializedName("fpx")
       Long fpx;
     }
@@ -211,15 +220,24 @@ public static class ConnectReserved extends StripeObject {
     @Setter
     @EqualsAndHashCode(callSuper = false)
     public static class SourceTypes extends StripeObject {
-      /** Amount for bank account. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/ach-deprecated">legacy US ACH
+       * payments</a>.
+       */
       @SerializedName("bank_account")
       Long bankAccount;
 
-      /** Amount for card. */
+      /**
+       * Amount coming from most payment methods, including cards as well as <a
+       * href="https://docs.stripe.com/payments/bank-debits">non-legacy bank debits</a>.
+       */
       @SerializedName("card")
       Long card;
 
-      /** Amount for FPX. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/payments/fpx">FPX</a>, a Malaysian
+       * payment method.
+       */
       @SerializedName("fpx")
       Long fpx;
     }
@@ -279,15 +297,24 @@ public static class NetAvailable extends StripeObject {
       @Setter
       @EqualsAndHashCode(callSuper = false)
       public static class SourceTypes extends StripeObject {
-        /** Amount for bank account. */
+        /**
+         * Amount coming from <a href="https://docs.stripe.com/ach-deprecated">legacy US ACH
+         * payments</a>.
+         */
         @SerializedName("bank_account")
         Long bankAccount;
 
-        /** Amount for card. */
+        /**
+         * Amount coming from most payment methods, including cards as well as <a
+         * href="https://docs.stripe.com/payments/bank-debits">non-legacy bank debits</a>.
+         */
         @SerializedName("card")
         Long card;
 
-        /** Amount for FPX. */
+        /**
+         * Amount coming from <a href="https://docs.stripe.com/payments/fpx">FPX</a>, a Malaysian
+         * payment method.
+         */
         @SerializedName("fpx")
         Long fpx;
       }
@@ -301,15 +328,24 @@ public static class SourceTypes extends StripeObject {
     @Setter
     @EqualsAndHashCode(callSuper = false)
     public static class SourceTypes extends StripeObject {
-      /** Amount for bank account. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/ach-deprecated">legacy US ACH
+       * payments</a>.
+       */
       @SerializedName("bank_account")
       Long bankAccount;
 
-      /** Amount for card. */
+      /**
+       * Amount coming from most payment methods, including cards as well as <a
+       * href="https://docs.stripe.com/payments/bank-debits">non-legacy bank debits</a>.
+       */
       @SerializedName("card")
       Long card;
 
-      /** Amount for FPX. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/payments/fpx">FPX</a>, a Malaysian
+       * payment method.
+       */
       @SerializedName("fpx")
       Long fpx;
     }
@@ -358,15 +394,24 @@ public static class Available extends StripeObject {
       @Setter
       @EqualsAndHashCode(callSuper = false)
       public static class SourceTypes extends StripeObject {
-        /** Amount for bank account. */
+        /**
+         * Amount coming from <a href="https://docs.stripe.com/ach-deprecated">legacy US ACH
+         * payments</a>.
+         */
         @SerializedName("bank_account")
         Long bankAccount;
 
-        /** Amount for card. */
+        /**
+         * Amount coming from most payment methods, including cards as well as <a
+         * href="https://docs.stripe.com/payments/bank-debits">non-legacy bank debits</a>.
+         */
         @SerializedName("card")
         Long card;
 
-        /** Amount for FPX. */
+        /**
+         * Amount coming from <a href="https://docs.stripe.com/payments/fpx">FPX</a>, a Malaysian
+         * payment method.
+         */
         @SerializedName("fpx")
         Long fpx;
       }
@@ -404,15 +449,24 @@ public static class Pending extends StripeObject {
     @Setter
     @EqualsAndHashCode(callSuper = false)
     public static class SourceTypes extends StripeObject {
-      /** Amount for bank account. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/ach-deprecated">legacy US ACH
+       * payments</a>.
+       */
       @SerializedName("bank_account")
       Long bankAccount;
 
-      /** Amount for card. */
+      /**
+       * Amount coming from most payment methods, including cards as well as <a
+       * href="https://docs.stripe.com/payments/bank-debits">non-legacy bank debits</a>.
+       */
       @SerializedName("card")
       Long card;
 
-      /** Amount for FPX. */
+      /**
+       * Amount coming from <a href="https://docs.stripe.com/payments/fpx">FPX</a>, a Malaysian
+       * payment method.
+       */
       @SerializedName("fpx")
       Long fpx;
     }

diff --git a/src/main/java/com/stripe/model/Charge.java b/src/main/java/com/stripe/model/Charge.java
@@ -1305,13 +1305,11 @@ public static class PaymentMethodDetails extends StripeObject {
     Twint twint;
 
     /**
-     * The type of transaction-specific details of the payment method used in the payment, one of
-     * {@code ach_credit_transfer}, {@code ach_debit}, {@code acss_debit}, {@code alipay}, {@code
-     * au_becs_debit}, {@code bancontact}, {@code card}, {@code card_present}, {@code eps}, {@code
-     * giropay}, {@code ideal}, {@code klarna}, {@code multibanco}, {@code p24}, {@code sepa_debit},
-     * {@code sofort}, {@code stripe_account}, or {@code wechat}. An additional hash is included on
-     * {@code payment_method_details} with a name matching this value. It contains information
-     * specific to the payment method.
+     * The type of transaction-specific details of the payment method used in the payment. See <a
+     * href="https://stripe.com/docs/api/payment_methods/object#payment_method_object-type">PaymentMethod.type</a>
+     * for the full list of possible types. An additional hash is included on {@code
+     * payment_method_details} with a name matching this value. It contains information specific to
+     * the payment method.
      */
     @SerializedName("type")
     String type;
@@ -1889,10 +1887,8 @@ public static class Card extends StripeObject {
       /**
        * This is used by the financial networks to identify a transaction. Visa calls this the
        * Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the
-       * Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network
-       * Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent
-       * the date (MM/DD). This field will be available for successful Visa, Mastercard, or American
-       * Express transactions and always null for other card brands.
+       * Acquirer Reference Data. This value will be present if it is returned by the financial
+       * network in the authorization response, and null otherwise.
        */
       @SerializedName("network_transaction_id")
       String networkTransactionId;
@@ -2454,10 +2450,8 @@ public static class CardPresent extends StripeObject {
       /**
        * This is used by the financial networks to identify a transaction. Visa calls this the
        * Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the
-       * Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network
-       * Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent
-       * the date (MM/DD). This field will be available for successful Visa, Mastercard, or American
-       * Express transactions and always null for other card brands.
+       * Acquirer Reference Data. This value will be present if it is returned by the financial
+       * network in the authorization response, and null otherwise.
        */
       @SerializedName("network_transaction_id")
       String networkTransactionId;
@@ -2917,10 +2911,8 @@ public static class InteracPresent extends StripeObject {
       /**
        * This is used by the financial networks to identify a transaction. Visa calls this the
        * Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the
-       * Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network
-       * Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent
-       * the date (MM/DD). This field will be available for successful Visa, Mastercard, or American
-       * Express transactions and always null for other card brands.
+       * Acquirer Reference Data. This value will be present if it is returned by the financial
+       * network in the authorization response, and null otherwise.
        */
       @SerializedName("network_transaction_id")
       String networkTransactionId;
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# All files should be reviewed by a member of the SDKs team
		* @stripe/api-library-reviewers