[generated] source: spec3.sdk.yaml@spec-19c20f3 in master (stripe#776)

src/main/java/com/stripe/model/Charge.java

@@ -986,10 +986,10 @@ public static class PaymentMethodDetails extends StripeObject {
 
     /**
      * The type of transaction-specific details of the payment method used in the payment, one of
-     * `ach_credit_transfer`, `alipay`, `bancontact`, `card`, `eps`, `giropay`, `ideal`,
-     * `multibanco`, `p24`, `sepa_debit`, or `sofort`. An additional hash is included on
-     * `payment_method_details` with a name matching this value. It contains information specific to
-     * the payment method.
+     * `ach_credit_transfer`, `ach_debit`, `alipay`, `bancontact`, `card`, `card_present`, `eps`,
+     * `giropay`, `ideal`, `multibanco`, `p24`, `sepa_debit`, `sofort`, `stripe_account`, or
+     * `wechat`. An additional hash is included on `payment_method_details` with a name matching
+     * this value. It contains information specific to the payment method.
      */
     @SerializedName("type")
     String type;

src/main/java/com/stripe/model/PaymentIntent.java

@@ -44,7 +44,8 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
 
   /**
    * The amount of the application fee (if any) for the resulting payment. See the PaymentIntents
-   * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+   * [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
    * details.
    */
   @SerializedName("application_fee_amount")
@@ -59,7 +60,7 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
 
   /**
    * User-given reason for cancellation of this PaymentIntent, one of `duplicate`, `fraudulent`,
-   * `requested_by_customer`, or `failed_invoice`.
+   * `requested_by_customer`, `failed_invoice`, or `void_invoice`.
    */
   @SerializedName("cancellation_reason")
   String cancellationReason;
@@ -150,8 +151,9 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
 
   /**
    * The account (if any) for which the funds of the PaymentIntent are intended. See the
-   * PaymentIntents [Connect usage
-   * guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for details.
+   * PaymentIntents [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
+   * details.
    */
   @SerializedName("on_behalf_of")
   @Getter(lombok.AccessLevel.NONE)
@@ -197,24 +199,25 @@ public class PaymentIntent extends ApiResource implements HasId, MetadataStore<P
 
   /**
    * Status of this PaymentIntent, one of `requires_payment_method`, `requires_confirmation`,
-   * `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. You can read
-   * more about PaymentIntent statuses
-   * [here](https://stripe.com/docs/payments/payment-intents/usage#paymentintent-status-overview).
+   * `requires_action`, `processing`, `requires_capture`, `canceled`, or `succeeded`. Read more
+   * about each PaymentIntent [status](https://stripe.com/docs/payments/payment-intents/status).
    */
   @SerializedName("status")
   String status;
 
   /**
    * The data with which to automatically create a Transfer when the payment is finalized. See the
-   * PaymentIntents [Connect usage
-   * guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for details.
+   * PaymentIntents [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
+   * details.
    */
   @SerializedName("transfer_data")
   TransferData transferData;
 
   /**
-   * A string that identifies the resulting payment as part of a group. See the PaymentIntents
-   * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+   * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use
+   * case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
    * details.
    */
   @SerializedName("transfer_group")

src/main/java/com/stripe/model/Subscription.java

@@ -198,6 +198,13 @@ public class Subscription extends ApiResource implements HasId, MetadataStore<Su
   @SerializedName("start")
   Long start;
 
+  /**
+   * Date when the subscription was first created. The date might differ from the `created` date due
+   * to backdating.
+   */
+  @SerializedName("start_date")
+  Long startDate;
+
   /**
    * Possible values are `incomplete`, `incomplete_expired`, `trialing`, `active`, `past_due`,
    * `canceled`, or `unpaid`.

src/main/java/com/stripe/param/InvoiceCreateParams.java

@@ -113,9 +113,10 @@ public class InvoiceCreateParams extends ApiRequestParams {
 
   /**
    * The ID of the subscription to invoice, if any. If not set, the created invoice will include all
-   * pending invoice items for the customer. If set, the created invoice will exclude pending
-   * invoice items that pertain to other subscriptions. The subscription's billing cycle and regular
-   * subscription events won't be affected.
+   * pending invoice items for the customer. If set, the created invoice will only include pending
+   * invoice items for that subscription and pending invoice items not associated with any
+   * subscription. The subscription's billing cycle and regular subscription events won't be
+   * affected.
    */
   @SerializedName("subscription")
   String subscription;
@@ -459,9 +460,10 @@ public Builder setStatementDescriptor(String statementDescriptor) {
 
     /**
      * The ID of the subscription to invoice, if any. If not set, the created invoice will include
-     * all pending invoice items for the customer. If set, the created invoice will exclude pending
-     * invoice items that pertain to other subscriptions. The subscription's billing cycle and
-     * regular subscription events won't be affected.
+     * all pending invoice items for the customer. If set, the created invoice will only include
+     * pending invoice items for that subscription and pending invoice items not associated with any
+     * subscription. The subscription's billing cycle and regular subscription events won't be
+     * affected.
      */
     public Builder setSubscription(String subscription) {
       this.subscription = subscription;

src/main/java/com/stripe/param/PaymentIntentCancelParams.java

@@ -120,9 +120,6 @@ public enum CancellationReason implements ApiRequestParams.EnumParam {
     @SerializedName("duplicate")
     DUPLICATE("duplicate"),
 
-    @SerializedName("failed_invoice")
-    FAILED_INVOICE("failed_invoice"),
-
     @SerializedName("fraudulent")
     FRAUDULENT("fraudulent"),
 

src/main/java/com/stripe/param/PaymentIntentCaptureParams.java

@@ -20,8 +20,9 @@ public class PaymentIntentCaptureParams extends ApiRequestParams {
 
   /**
    * The amount of the application fee (if any) that will be applied to the payment and transferred
-   * to the application owner's Stripe account. For more information, see the PaymentIntents
-   * [Connect usage guide](/docs/payments/payment-intents/usage#connect).
+   * to the application owner's Stripe account. For more information, see the PaymentIntents [use
+   * case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
    */
   @SerializedName("application_fee_amount")
   Long applicationFeeAmount;
@@ -82,7 +83,8 @@ public Builder setAmountToCapture(Long amountToCapture) {
     /**
      * The amount of the application fee (if any) that will be applied to the payment and
      * transferred to the application owner's Stripe account. For more information, see the
-     * PaymentIntents [Connect usage guide](/docs/payments/payment-intents/usage#connect).
+     * PaymentIntents [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     public Builder setApplicationFeeAmount(Long applicationFeeAmount) {
       this.applicationFeeAmount = applicationFeeAmount;

src/main/java/com/stripe/param/PaymentIntentCreateParams.java

@@ -23,8 +23,9 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
 
   /**
    * The amount of the application fee (if any) that will be applied to the payment and transferred
-   * to the application owner's Stripe account. For more information, see the PaymentIntents
-   * [Connect usage guide](/docs/payments/payment-intents/usage#connect).
+   * to the application owner's Stripe account. For more information, see the PaymentIntents [use
+   * case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
    */
   @SerializedName("application_fee_amount")
   Long applicationFeeAmount;
@@ -95,7 +96,8 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
 
   /**
    * The Stripe account ID for which these funds are intended. For details, see the PaymentIntents
-   * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+   * [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
    */
   @SerializedName("on_behalf_of")
   String onBehalfOf;
@@ -152,15 +154,16 @@ public class PaymentIntentCreateParams extends ApiRequestParams {
 
   /**
    * The parameters used to automatically create a Transfer when the payment succeeds. For more
-   * information, see the PaymentIntents [Connect usage
-   * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+   * information, see the PaymentIntents [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
    */
   @SerializedName("transfer_data")
   TransferData transferData;
 
   /**
-   * A string that identifies the resulting payment as part of a group. See the PaymentIntents
-   * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+   * A string that identifies the resulting payment as part of a group. See the PaymentIntents [use
+   * case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
    * details.
    */
   @SerializedName("transfer_group")
@@ -304,7 +307,8 @@ public Builder setAmount(Long amount) {
     /**
      * The amount of the application fee (if any) that will be applied to the payment and
      * transferred to the application owner's Stripe account. For more information, see the
-     * PaymentIntents [Connect usage guide](/docs/payments/payment-intents/usage#connect).
+     * PaymentIntents [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     public Builder setApplicationFeeAmount(Long applicationFeeAmount) {
       this.applicationFeeAmount = applicationFeeAmount;
@@ -447,7 +451,8 @@ public Builder putAllMetadata(Map<String, String> map) {
 
     /**
      * The Stripe account ID for which these funds are intended. For details, see the PaymentIntents
-     * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+     * [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     public Builder setOnBehalfOf(String onBehalfOf) {
       this.onBehalfOf = onBehalfOf;
@@ -540,8 +545,8 @@ public Builder setStatementDescriptor(String statementDescriptor) {
 
     /**
      * The parameters used to automatically create a Transfer when the payment succeeds. For more
-     * information, see the PaymentIntents [Connect usage
-     * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+     * information, see the PaymentIntents [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     public Builder setTransferData(TransferData transferData) {
       this.transferData = transferData;
@@ -550,7 +555,8 @@ public Builder setTransferData(TransferData transferData) {
 
     /**
      * A string that identifies the resulting payment as part of a group. See the PaymentIntents
-     * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+     * [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
      * details.
      */
     public Builder setTransferGroup(String transferGroup) {

src/main/java/com/stripe/param/PaymentIntentUpdateParams.java

@@ -17,7 +17,8 @@ public class PaymentIntentUpdateParams extends ApiRequestParams {
 
   /**
    * The amount of the application fee (if any) for the resulting payment. See the PaymentIntents
-   * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+   * [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
    * details.
    */
   @SerializedName("application_fee_amount")
@@ -99,8 +100,9 @@ public class PaymentIntentUpdateParams extends ApiRequestParams {
 
   /**
    * A string that identifies the resulting payment as part of a group. `transfer_group` may only be
-   * provided if it has not been set. See the PaymentIntents [Connect usage
-   * guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for details.
+   * provided if it has not been set. See the PaymentIntents [use case for connected
+   * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
+   * details.
    */
   @SerializedName("transfer_group")
   String transferGroup;
@@ -206,7 +208,8 @@ public Builder setAmount(Long amount) {
 
     /**
      * The amount of the application fee (if any) for the resulting payment. See the PaymentIntents
-     * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+     * [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
      * details.
      */
     public Builder setApplicationFeeAmount(EmptyParam applicationFeeAmount) {
@@ -216,7 +219,8 @@ public Builder setApplicationFeeAmount(EmptyParam applicationFeeAmount) {
 
     /**
      * The amount of the application fee (if any) for the resulting payment. See the PaymentIntents
-     * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for
+     * [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
      * details.
      */
     public Builder setApplicationFeeAmount(Long applicationFeeAmount) {
@@ -404,8 +408,9 @@ public Builder setStatementDescriptor(String statementDescriptor) {
 
     /**
      * A string that identifies the resulting payment as part of a group. `transfer_group` may only
-     * be provided if it has not been set. See the PaymentIntents [Connect usage
-     * guide](https://stripe.com/docs/payments/payment-intents/usage#connect) for details.
+     * be provided if it has not been set. See the PaymentIntents [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts) for
+     * details.
      */
     public Builder setTransferGroup(String transferGroup) {
       this.transferGroup = transferGroup;

src/main/java/com/stripe/param/checkout/SessionCreateParams.java

@@ -545,8 +545,8 @@ public static class PaymentIntentData {
      * The amount of the application fee (if any) that will be applied to the payment and
      * transferred to the application owner's Stripe account. To use an application fee, the request
      * must be made on behalf of another account, using the `Stripe-Account` header or an OAuth key.
-     * For more information, see the PaymentIntents [Connect usage
-     * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+     * For more information, see the PaymentIntents [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     @SerializedName("application_fee_amount")
     Long applicationFeeAmount;
@@ -577,7 +577,8 @@ public static class PaymentIntentData {
 
     /**
      * The Stripe account ID for which these funds are intended. For details, see the PaymentIntents
-     * [Connect usage guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+     * [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     @SerializedName("on_behalf_of")
     String onBehalfOf;
@@ -599,8 +600,8 @@ public static class PaymentIntentData {
 
     /**
      * The parameters used to automatically create a Transfer when the payment succeeds. For more
-     * information, see the PaymentIntents [Connect usage
-     * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+     * information, see the PaymentIntents [use case for connected
+     * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
      */
     @SerializedName("transfer_data")
     TransferData transferData;
@@ -672,8 +673,8 @@ public PaymentIntentData build() {
        * The amount of the application fee (if any) that will be applied to the payment and
        * transferred to the application owner's Stripe account. To use an application fee, the
        * request must be made on behalf of another account, using the `Stripe-Account` header or an
-       * OAuth key. For more information, see the PaymentIntents [Connect usage
-       * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+       * OAuth key. For more information, see the PaymentIntents [use case for connected
+       * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
        */
       public Builder setApplicationFeeAmount(Long applicationFeeAmount) {
         this.applicationFeeAmount = applicationFeeAmount;
@@ -746,8 +747,8 @@ public Builder putAllMetadata(Map<String, String> map) {
 
       /**
        * The Stripe account ID for which these funds are intended. For details, see the
-       * PaymentIntents [Connect usage
-       * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+       * PaymentIntents [use case for connected
+       * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
        */
       public Builder setOnBehalfOf(String onBehalfOf) {
         this.onBehalfOf = onBehalfOf;
@@ -777,8 +778,8 @@ public Builder setStatementDescriptor(String statementDescriptor) {
 
       /**
        * The parameters used to automatically create a Transfer when the payment succeeds. For more
-       * information, see the PaymentIntents [Connect usage
-       * guide](https://stripe.com/docs/payments/payment-intents/usage#connect).
+       * information, see the PaymentIntents [use case for connected
+       * accounts](https://stripe.com/docs/payments/payment-intents/use-cases#connected-accounts).
        */
       public Builder setTransferData(TransferData transferData) {
         this.transferData = transferData;

src/main/java/com/stripe/param/issuing/CardCreateParams.java

@@ -55,10 +55,7 @@ public class CardCreateParams extends ApiRequestParams {
   @SerializedName("replacement_reason")
   ReplacementReason replacementReason;
 
-  /**
-   * The address where the card will be shipped. This will default to the cardholder's billing
-   * address for physical cards.
-   */
+  /** The address where the card will be shipped. */
   @SerializedName("shipping")
   Shipping shipping;
 
@@ -256,10 +253,7 @@ public Builder setReplacementReason(ReplacementReason replacementReason) {
       return this;
     }
 
-    /**
-     * The address where the card will be shipped. This will default to the cardholder's billing
-     * address for physical cards.
-     */
+    /** The address where the card will be shipped. */
     public Builder setShipping(Shipping shipping) {
       this.shipping = shipping;
       return this;