stripe · stripe-openapi · Jan 25, 2025 · Jan 27, 2025 · Jan 27, 2025 · Feb 5, 2025
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/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -139,6 +139,8 @@ jobs:
       endsWith(github.actor, '-stripe')
     needs: [build, test]
     runs-on: "ubuntu-24.04"
+    permissions:
+        contents: write
     steps:
       - uses: actions/checkout@master
       - name: Setup Java

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # 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.4.0-beta.1 - 2025-02-07
 * [#1942](https://github.com/stripe/stripe-java/pull/1942) Update generated code for beta
   * Add support for `rejected_reason` on `Account.risk_controls`
@@ -9,6 +22,9 @@
   * Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `checkout.SessionCreateParams.payment_method_options.card`
   * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
 
+## 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/OPENAPI_VERSION b/OPENAPI_VERSION
@@ -1 +1 @@
-v1472
+v1540
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-03-31.basil";
 }
diff --git a/src/main/java/com/stripe/model/ApplicationFee.java b/src/main/java/com/stripe/model/ApplicationFee.java
@@ -319,7 +319,7 @@ public static class FeeSource extends StripeObject {
     String payout;
 
     /**
-     * Type of object that created the application fee, either {@code charge} or {@code payout}.
+     * Type of object that created the application fee.
      *
      * <p>One of {@code charge}, or {@code payout}.
      */

diff --git a/src/main/java/com/stripe/model/BankAccount.java b/src/main/java/com/stripe/model/BankAccount.java
@@ -34,7 +34,14 @@
 @EqualsAndHashCode(callSuper = false)
 public class BankAccount extends ApiResource
     implements MetadataStore<BankAccount>, ExternalAccount, PaymentSource {
-  /** The ID of the account that the bank account is associated with. */
+  /**
+   * The account this bank account belongs to. Only applicable on Accounts (not customers or
+   * recipients) This property is only available when returned as an <a
+   * href="https://stripe.com/api/external_account_bank_accounts/object">External Account</a> where
+   * <a
+   * href="https://stripe.com/api/accounts/object#account_object-controller-is_controller">controller.is_controller</a>
+   * is {@code true}.
+   */
   @SerializedName("account")
   @Getter(lombok.AccessLevel.NONE)
   @Setter(lombok.AccessLevel.NONE)

diff --git a/src/main/java/com/stripe/model/Card.java b/src/main/java/com/stripe/model/Card.java
@@ -28,13 +28,6 @@
 @EqualsAndHashCode(callSuper = false)
 public class Card extends ApiResource
     implements MetadataStore<Card>, ExternalAccount, PaymentSource {
-  /**
-   * The account this card belongs to. This attribute will not be in the card object if the card
-   * belongs to a customer or recipient instead. This property is only available for accounts where
-   * <a
-   * href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
-   * is {@code application}, which includes Custom accounts.
-   */
   @SerializedName("account")
   @Getter(lombok.AccessLevel.NONE)
   @Setter(lombok.AccessLevel.NONE)
@@ -123,10 +116,11 @@ public class Card extends ApiResource
    * Three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO code for
    * currency</a> in lowercase. Must be a <a href="https://docs.stripe.com/currencies">supported
    * currency</a>. Only applicable on accounts (not customers or recipients). The card can be used
-   * as a transfer destination for funds in this currency. This property is only available for
-   * accounts where <a
-   * href="https://stripe.com/api/accounts/object#account_object-controller-requirement_collection">controller.requirement_collection</a>
-   * is {@code application}, which includes Custom accounts.
+   * as a transfer destination for funds in this currency. This property is only available when
+   * returned as an <a href="https://stripe.com/api/external_account_cards/object">External
+   * Account</a> where <a
+   * href="https://stripe.com/api/accounts/object#account_object-controller-is_controller">controller.is_controller</a>
+   * is {@code true}.
    */
   @SerializedName("currency")
   String currency;

diff --git a/src/main/java/com/stripe/model/Charge.java b/src/main/java/com/stripe/model/Charge.java
@@ -1326,13 +1326,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;

diff --git a/src/main/java/com/stripe/model/CustomerBalanceTransaction.java b/src/main/java/com/stripe/model/CustomerBalanceTransaction.java
@@ -111,13 +111,17 @@ public class CustomerBalanceTransaction extends ApiResource
   /**
    * Transaction type: {@code adjustment}, {@code applied_to_invoice}, {@code credit_note}, {@code
    * initial}, {@code invoice_overpaid}, {@code invoice_too_large}, {@code invoice_too_small},
-   * {@code unspent_receiver_credit}, or {@code unapplied_from_invoice}. See the <a
+   * {@code unspent_receiver_credit}, {@code unapplied_from_invoice}, {@code
+   * checkout_session_subscription_payment}, or {@code
+   * checkout_session_subscription_payment_canceled}. See the <a
    * href="https://stripe.com/docs/billing/customer/balance#types">Customer Balance page</a> to
    * learn more about transaction types.
    *
-   * <p>One of {@code adjustment}, {@code applied_to_invoice}, {@code credit_note}, {@code initial},
-   * {@code invoice_overpaid}, {@code invoice_too_large}, {@code invoice_too_small}, {@code
-   * migration}, {@code unapplied_from_invoice}, or {@code unspent_receiver_credit}.
+   * <p>One of {@code adjustment}, {@code applied_to_invoice}, {@code
+   * checkout_session_subscription_payment}, {@code checkout_session_subscription_payment_canceled},
+   * {@code credit_note}, {@code initial}, {@code invoice_overpaid}, {@code invoice_too_large},
+   * {@code invoice_too_small}, {@code migration}, {@code unapplied_from_invoice}, or {@code
+   * unspent_receiver_credit}.
    */
   @SerializedName("type")
   String type;

diff --git a/src/main/java/com/stripe/model/Invoice.java b/src/main/java/com/stripe/model/Invoice.java
@@ -103,8 +103,8 @@ public class Invoice extends ApiResource implements HasId, MetadataStore<Invoice
   Long amountDue;
 
   /**
-   * Amount that was overpaid on the invoice. Overpayments are debited to the customer's credit
-   * balance.
+   * Amount that was overpaid on the invoice. The amount overpaid is credited to the customer's
+   * credit balance.
    */
   @SerializedName("amount_overpaid")
   Long amountOverpaid;

diff --git a/src/main/java/com/stripe/model/InvoiceItem.java b/src/main/java/com/stripe/model/InvoiceItem.java
@@ -133,17 +133,6 @@ public class InvoiceItem extends ApiResource implements HasId, MetadataStore<Inv
   @SerializedName("period")
   Period period;
 
-  /**
-   * If the invoice item is a proration, the plan of the subscription that the proration was
-   * computed for.
-   */
-  @SerializedName("plan")
-  Plan plan;
-
-  /** The price of the invoice item. */
-  @SerializedName("price")
-  Price price;
-
   /**
    * Whether the invoice item was created automatically as a proration adjustment when the customer
    * switched plans.
@@ -583,8 +572,6 @@ public void setResponseGetter(StripeResponseGetter responseGetter) {
     trySetResponseGetter(customer, responseGetter);
     trySetResponseGetter(invoice, responseGetter);
     trySetResponseGetter(period, responseGetter);
-    trySetResponseGetter(plan, responseGetter);
-    trySetResponseGetter(price, responseGetter);
     trySetResponseGetter(subscription, responseGetter);
     trySetResponseGetter(testClock, responseGetter);
   }

diff --git a/src/main/java/com/stripe/model/Order.java b/src/main/java/com/stripe/model/Order.java
@@ -928,6 +928,14 @@ public static class AcssDebit extends StripeObject {
           @SerializedName("setup_future_usage")
           String setupFutureUsage;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The
+           * date must be a string in YYYY-MM-DD format. The date must be in the future and between
+           * 3 and 15 calendar days from now.
+           */
+          @SerializedName("target_date")
+          String targetDate;
+
           /**
            * Bank account verification method.
            *
@@ -1630,6 +1638,14 @@ public static class SepaDebit extends StripeObject {
           @SerializedName("setup_future_usage")
           String setupFutureUsage;
 
+          /**
+           * Controls when Stripe will attempt to debit the funds from the customer's account. The
+           * date must be a string in YYYY-MM-DD format. The date must be in the future and between
+           * 3 and 15 calendar days from now.
+           */
+          @SerializedName("target_date")
+          String targetDate;
+
           /**
            * For more details about MandateOptions, please refer to the <a
            * href="https://docs.stripe.com/api">API Reference.</a>
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