stripe 19.2.0-beta.1 → 19.3.0-beta.1

package/types/PaymentLinks.d.ts

@@ -105,6 +105,8 @@ declare module 'stripe' {
        */
       metadata: Stripe.Metadata;
 
+      name_collection?: PaymentLink.NameCollection;
+
       /**
        * The account on behalf of which to charge. See the [Connect documentation](https://support.stripe.com/questions/sending-invoices-on-behalf-of-connected-accounts) for details.
        */
@@ -518,6 +520,38 @@ declare module 'stripe' {
         }
       }
 
+      interface NameCollection {
+        business?: NameCollection.Business;
+
+        individual?: NameCollection.Individual;
+      }
+
+      namespace NameCollection {
+        interface Business {
+          /**
+           * Indicates whether business name collection is enabled for the payment link.
+           */
+          enabled: boolean;
+
+          /**
+           * Whether the customer is required to complete the field before checking out. Defaults to `false`.
+           */
+          optional: boolean;
+        }
+
+        interface Individual {
+          /**
+           * Indicates whether individual name collection is enabled for the payment link.
+           */
+          enabled: boolean;
+
+          /**
+           * Whether the customer is required to complete the field before checking out. Defaults to `false`.
+           */
+          optional: boolean;
+        }
+      }
+
       interface OptionalItem {
         adjustable_quantity: OptionalItem.AdjustableQuantity | null;
 

package/types/PaymentLinksResource.d.ts

@@ -83,6 +83,11 @@ declare module 'stripe' {
        */
       metadata?: Stripe.MetadataParam;
 
+      /**
+       * Controls settings applied for collecting the customer's name.
+       */
+      name_collection?: PaymentLinkCreateParams.NameCollection;
+
       /**
        * The account on behalf of which to charge.
        */
@@ -663,6 +668,44 @@ declare module 'stripe' {
         }
       }
 
+      interface NameCollection {
+        /**
+         * Controls settings applied for collecting the customer's business name.
+         */
+        business?: NameCollection.Business;
+
+        /**
+         * Controls settings applied for collecting the customer's individual name.
+         */
+        individual?: NameCollection.Individual;
+      }
+
+      namespace NameCollection {
+        interface Business {
+          /**
+           * Enable business name collection on the payment link. Defaults to `false`.
+           */
+          enabled: boolean;
+
+          /**
+           * Whether the customer is required to provide their business name before checking out. Defaults to `false`.
+           */
+          optional?: boolean;
+        }
+
+        interface Individual {
+          /**
+           * Enable individual name collection on the payment link. Defaults to `false`.
+           */
+          enabled: boolean;
+
+          /**
+           * Whether the customer is required to provide their full name before checking out. Defaults to `false`.
+           */
+          optional?: boolean;
+        }
+      }
+
       interface OptionalItem {
         /**
          * When set, provides configuration for the customer to adjust the quantity of the line item created when a customer chooses to add this optional item to their order.
@@ -1265,6 +1308,13 @@ declare module 'stripe' {
        */
       metadata?: Stripe.MetadataParam;
 
+      /**
+       * Controls settings applied for collecting the customer's name.
+       */
+      name_collection?: Stripe.Emptyable<
+        PaymentLinkUpdateParams.NameCollection
+      >;
+
       /**
        * A subset of parameters to be passed to PaymentIntent creation for Checkout Sessions in `payment` mode.
        */
@@ -1695,6 +1745,44 @@ declare module 'stripe' {
         }
       }
 
+      interface NameCollection {
+        /**
+         * Controls settings applied for collecting the customer's business name.
+         */
+        business?: NameCollection.Business;
+
+        /**
+         * Controls settings applied for collecting the customer's individual name.
+         */
+        individual?: NameCollection.Individual;
+      }
+
+      namespace NameCollection {
+        interface Business {
+          /**
+           * Enable business name collection on the payment link. Defaults to `false`.
+           */
+          enabled: boolean;
+
+          /**
+           * Whether the customer is required to provide their business name before checking out. Defaults to `false`.
+           */
+          optional?: boolean;
+        }
+
+        interface Individual {
+          /**
+           * Enable individual name collection on the payment link. Defaults to `false`.
+           */
+          enabled: boolean;
+
+          /**
+           * Whether the customer is required to provide their full name before checking out. Defaults to `false`.
+           */
+          optional?: boolean;
+        }
+      }
+
       interface PaymentIntentData {
         /**
          * An arbitrary string attached to the object. Often useful for displaying to users.

package/types/PaymentMethodConfigurations.d.ts

@@ -71,6 +71,8 @@ declare module 'stripe' {
 
       cashapp?: PaymentMethodConfiguration.Cashapp;
 
+      crypto?: PaymentMethodConfiguration.Crypto;
+
       customer_balance?: PaymentMethodConfiguration.CustomerBalance;
 
       eps?: PaymentMethodConfiguration.Eps;
@@ -111,6 +113,8 @@ declare module 'stripe' {
        */
       livemode: boolean;
 
+      mb_way?: PaymentMethodConfiguration.MbWay;
+
       mobilepay?: PaymentMethodConfiguration.Mobilepay;
 
       multibanco?: PaymentMethodConfiguration.Multibanco;
@@ -719,6 +723,40 @@ declare module 'stripe' {
         }
       }
 
+      interface Crypto {
+        /**
+         * Whether this payment method may be offered at checkout. True if `display_preference` is `on` and the payment method's capability is active.
+         */
+        available: boolean;
+
+        display_preference: Crypto.DisplayPreference;
+      }
+
+      namespace Crypto {
+        interface DisplayPreference {
+          /**
+           * For child configs, whether or not the account's preference will be observed. If `false`, the parent configuration's default is used.
+           */
+          overridable: boolean | null;
+
+          /**
+           * The account's display preference.
+           */
+          preference: DisplayPreference.Preference;
+
+          /**
+           * The effective display preference value.
+           */
+          value: DisplayPreference.Value;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+
+          type Value = 'off' | 'on';
+        }
+      }
+
       interface CustomerBalance {
         /**
          * Whether this payment method may be offered at checkout. True if `display_preference` is `on` and the payment method's capability is active.
@@ -1229,6 +1267,40 @@ declare module 'stripe' {
         }
       }
 
+      interface MbWay {
+        /**
+         * Whether this payment method may be offered at checkout. True if `display_preference` is `on` and the payment method's capability is active.
+         */
+        available: boolean;
+
+        display_preference: MbWay.DisplayPreference;
+      }
+
+      namespace MbWay {
+        interface DisplayPreference {
+          /**
+           * For child configs, whether or not the account's preference will be observed. If `false`, the parent configuration's default is used.
+           */
+          overridable: boolean | null;
+
+          /**
+           * The account's display preference.
+           */
+          preference: DisplayPreference.Preference;
+
+          /**
+           * The effective display preference value.
+           */
+          value: DisplayPreference.Value;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+
+          type Value = 'off' | 'on';
+        }
+      }
+
       interface Mobilepay {
         /**
          * Whether this payment method may be offered at checkout. True if `display_preference` is `on` and the payment method's capability is active.

package/types/PaymentMethodConfigurationsResource.d.ts

@@ -88,6 +88,11 @@ declare module 'stripe' {
        */
       cashapp?: PaymentMethodConfigurationCreateParams.Cashapp;
 
+      /**
+       * [Stablecoin payments](https://stripe.com/docs/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask.
+       */
+      crypto?: PaymentMethodConfigurationCreateParams.Crypto;
+
       /**
        * Uses a customer's [cash balance](https://stripe.com/docs/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://stripe.com/docs/payments/bank-transfers) for more details.
        */
@@ -173,6 +178,11 @@ declare module 'stripe' {
        */
       link?: PaymentMethodConfigurationCreateParams.Link;
 
+      /**
+       * MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://stripe.com/docs/payments/mb-way) for more details.
+       */
+      mb_way?: PaymentMethodConfigurationCreateParams.MbWay;
+
       /**
        * MobilePay is a [single-use](https://stripe.com/docs/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://stripe.com/docs/payments/mobilepay) for more details.
        */
@@ -655,6 +665,26 @@ declare module 'stripe' {
         }
       }
 
+      interface Crypto {
+        /**
+         * Whether or not the payment method should be displayed.
+         */
+        display_preference?: Crypto.DisplayPreference;
+      }
+
+      namespace Crypto {
+        interface DisplayPreference {
+          /**
+           * The account's preference for whether or not to display this payment method.
+           */
+          preference?: DisplayPreference.Preference;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+        }
+      }
+
       interface CustomerBalance {
         /**
          * Whether or not the payment method should be displayed.
@@ -975,6 +1005,26 @@ declare module 'stripe' {
         }
       }
 
+      interface MbWay {
+        /**
+         * Whether or not the payment method should be displayed.
+         */
+        display_preference?: MbWay.DisplayPreference;
+      }
+
+      namespace MbWay {
+        interface DisplayPreference {
+          /**
+           * The account's preference for whether or not to display this payment method.
+           */
+          preference?: DisplayPreference.Preference;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+        }
+      }
+
       interface Mobilepay {
         /**
          * Whether or not the payment method should be displayed.
@@ -1594,6 +1644,11 @@ declare module 'stripe' {
        */
       cashapp?: PaymentMethodConfigurationUpdateParams.Cashapp;
 
+      /**
+       * [Stablecoin payments](https://stripe.com/docs/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask.
+       */
+      crypto?: PaymentMethodConfigurationUpdateParams.Crypto;
+
       /**
        * Uses a customer's [cash balance](https://stripe.com/docs/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://stripe.com/docs/payments/bank-transfers) for more details.
        */
@@ -1679,6 +1734,11 @@ declare module 'stripe' {
        */
       link?: PaymentMethodConfigurationUpdateParams.Link;
 
+      /**
+       * MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://stripe.com/docs/payments/mb-way) for more details.
+       */
+      mb_way?: PaymentMethodConfigurationUpdateParams.MbWay;
+
       /**
        * MobilePay is a [single-use](https://stripe.com/docs/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://stripe.com/docs/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://stripe.com/docs/payments/mobilepay) for more details.
        */
@@ -2156,6 +2216,26 @@ declare module 'stripe' {
         }
       }
 
+      interface Crypto {
+        /**
+         * Whether or not the payment method should be displayed.
+         */
+        display_preference?: Crypto.DisplayPreference;
+      }
+
+      namespace Crypto {
+        interface DisplayPreference {
+          /**
+           * The account's preference for whether or not to display this payment method.
+           */
+          preference?: DisplayPreference.Preference;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+        }
+      }
+
       interface CustomerBalance {
         /**
          * Whether or not the payment method should be displayed.
@@ -2476,6 +2556,26 @@ declare module 'stripe' {
         }
       }
 
+      interface MbWay {
+        /**
+         * Whether or not the payment method should be displayed.
+         */
+        display_preference?: MbWay.DisplayPreference;
+      }
+
+      namespace MbWay {
+        interface DisplayPreference {
+          /**
+           * The account's preference for whether or not to display this payment method.
+           */
+          preference?: DisplayPreference.Preference;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+        }
+      }
+
       interface Mobilepay {
         /**
          * Whether or not the payment method should be displayed.

package/types/PaymentMethods.d.ts

@@ -64,6 +64,8 @@ declare module 'stripe' {
 
       crypto?: PaymentMethod.Crypto;
 
+      custom?: PaymentMethod.Custom;
+
       /**
        * The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
        */
@@ -913,6 +915,37 @@ declare module 'stripe' {
 
       interface Crypto {}
 
+      interface Custom {
+        /**
+         * Display name of the Dashboard-only CustomPaymentMethodType.
+         */
+        display_name: string | null;
+
+        /**
+         * Contains information about the Dashboard-only CustomPaymentMethodType logo.
+         */
+        logo: Custom.Logo | null;
+
+        /**
+         * ID of the Dashboard-only CustomPaymentMethodType. Not expandable.
+         */
+        type: string;
+      }
+
+      namespace Custom {
+        interface Logo {
+          /**
+           * Content type of the Dashboard-only CustomPaymentMethodType logo.
+           */
+          content_type: string | null;
+
+          /**
+           * URL of the Dashboard-only CustomPaymentMethodType logo.
+           */
+          url: string;
+        }
+      }
+
       interface CustomerBalance {}
 
       interface Eps {
@@ -1524,6 +1557,7 @@ declare module 'stripe' {
         | 'card_present'
         | 'cashapp'
         | 'crypto'
+        | 'custom'
         | 'customer_balance'
         | 'eps'
         | 'fpx'

package/types/PaymentMethodsResource.d.ts

@@ -88,6 +88,11 @@ declare module 'stripe' {
        */
       crypto?: PaymentMethodCreateParams.Crypto;
 
+      /**
+       * If this is a `custom` PaymentMethod, this hash contains details about the Custom payment method.
+       */
+      custom?: PaymentMethodCreateParams.Custom;
+
       /**
        * The `Customer` to whom the original PaymentMethod is attached.
        */
@@ -477,6 +482,13 @@ declare module 'stripe' {
 
       interface Crypto {}
 
+      interface Custom {
+        /**
+         * ID of the Dashboard-only CustomPaymentMethodType. This field is used by Stripe products' internal code to support CPMs.
+         */
+        type: string;
+      }
+
       interface CustomerBalance {}
 
       interface Eps {
@@ -852,6 +864,7 @@ declare module 'stripe' {
         | 'card'
         | 'cashapp'
         | 'crypto'
+        | 'custom'
         | 'customer_balance'
         | 'eps'
         | 'fpx'
@@ -1085,7 +1098,7 @@ declare module 'stripe' {
       expand?: Array<string>;
 
       /**
-       * An optional filter on the list, based on the object `type` field. Without the filter, the list includes all current and future payment method types. If your integration expects only one type of payment method in the response, make sure to provide a type value in the request.
+       * Filters the list by the object `type` field. Unfiltered, the list returns all payment method types except `custom`. If your integration expects only one type of payment method in the response, specify that type value in the request to reduce your payload.
        */
       type?: PaymentMethodListParams.Type;
     }
@@ -1107,6 +1120,7 @@ declare module 'stripe' {
         | 'card'
         | 'cashapp'
         | 'crypto'
+        | 'custom'
         | 'customer_balance'
         | 'eps'
         | 'fpx'

package/types/PaymentRecords.d.ts

@@ -1179,7 +1179,7 @@ declare module 'stripe' {
         }
 
         namespace Crypto {
-          type Network = 'base' | 'ethereum' | 'polygon';
+          type Network = 'base' | 'ethereum' | 'polygon' | 'solana';
 
           type TokenCurrency = 'usdc' | 'usdg' | 'usdp';
         }
@@ -2012,7 +2012,12 @@ declare module 'stripe' {
 
         interface Qris {}
 
-        interface Rechnung {}
+        interface Rechnung {
+          /**
+           * Payment portal URL.
+           */
+          payment_portal_url: string | null;
+        }
 
         interface RevolutPay {
           funding?: RevolutPay.Funding;

package/types/PaymentRecordsResource.d.ts

@@ -478,6 +478,85 @@ declare module 'stripe' {
       }
     }
 
+    interface PaymentRecordReportRefundParams {
+      /**
+       * The outcome of the reported refund.
+       */
+      outcome: 'refunded';
+
+      /**
+       * Processor information for this refund.
+       */
+      processor_details: PaymentRecordReportRefundParams.ProcessorDetails;
+
+      /**
+       * Information about the payment attempt refund.
+       */
+      refunded: PaymentRecordReportRefundParams.Refunded;
+
+      /**
+       * A positive integer in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) representing how much of this payment to refund. Can refund only up to the remaining, unrefunded amount of the payment.
+       */
+      amount?: PaymentRecordReportRefundParams.Amount;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      /**
+       * When the reported refund was initiated. Measured in seconds since the Unix epoch.
+       */
+      initiated_at?: number;
+
+      /**
+       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       */
+      metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
+    }
+
+    namespace PaymentRecordReportRefundParams {
+      interface Amount {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
+         */
+        value: number;
+      }
+
+      interface ProcessorDetails {
+        /**
+         * Information about the custom processor used to make this refund.
+         */
+        custom?: ProcessorDetails.Custom;
+
+        /**
+         * The type of the processor details. An additional hash is included on processor_details with a name matching this value. It contains additional information specific to the processor.
+         */
+        type: 'custom';
+      }
+
+      namespace ProcessorDetails {
+        interface Custom {
+          /**
+           * A reference to the external refund. This field must be unique across all refunds.
+           */
+          refund_reference: string;
+        }
+      }
+
+      interface Refunded {
+        /**
+         * When the reported refund completed. Measured in seconds since the Unix epoch.
+         */
+        refunded_at: number;
+      }
+    }
+
     class PaymentRecordsResource {
       /**
        * Retrieves a Payment Record with the given ID
@@ -554,6 +633,16 @@ declare module 'stripe' {
         id: string,
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+
+      /**
+       * Report that the most recent payment attempt on the specified Payment Record
+       *  was refunded.
+       */
+      reportRefund(
+        id: string,
+        params: PaymentRecordReportRefundParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
     }
   }
 }

package/types/PayoutsResource.d.ts

@@ -183,7 +183,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.Payout>>;
 
       /**
-       * Reverses a payout by debiting the destination bank account. At this time, you can only reverse payouts for connected accounts to US bank accounts. If the payout is manual and in the pending status, use /v1/payouts/:id/cancel instead.
+       * Reverses a payout by debiting the destination bank account. At this time, you can only reverse payouts for connected accounts to US and Canadian bank accounts. If the payout is manual and in the pending status, use /v1/payouts/:id/cancel instead.
        *
        * By requesting a reversal through /v1/payouts/:id/reverse, you confirm that the authorized signatory of the selected bank account authorizes the debit on the bank account and that no other authorization is required.
        */

package/types/Persons.d.ts

@@ -404,6 +404,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'
@@ -612,6 +613,7 @@ declare module 'stripe' {
             | 'invalid_url_website_other'
             | 'invalid_value_other'
             | 'unsupported_business_type'
+            | 'verification_data_not_found'
             | 'verification_directors_mismatch'
             | 'verification_document_address_mismatch'
             | 'verification_document_address_missing'

package/types/QuotePreviewInvoices.d.ts

@@ -990,6 +990,7 @@ declare module 'stripe' {
           | 'payment_intent_mandate_invalid'
           | 'payment_intent_payment_attempt_expired'
           | 'payment_intent_payment_attempt_failed'
+          | 'payment_intent_rate_limit_exceeded'
           | 'payment_intent_unexpected_state'
           | 'payment_method_bank_account_already_verified'
           | 'payment_method_bank_account_blocked'