stripe 16.6.0 → 16.7.0-beta.1

package/types/Checkout/Sessions.d.ts

@@ -1487,6 +1487,11 @@ declare module 'stripe' {
              * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
              */
             setup_future_usage?: Paypal.SetupFutureUsage;
+
+            /**
+             * The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
+             */
+            subsellers?: Array<string>;
           }
 
           namespace Paypal {
@@ -1578,6 +1583,8 @@ declare module 'stripe' {
             interface FinancialConnections {
               filters?: FinancialConnections.Filters;
 
+              manual_entry?: FinancialConnections.ManualEntry;
+
               /**
                * The list of permissions to request. The `payment_method` permission must be included.
                */
@@ -1600,19 +1607,39 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * The institution to use to filter for possible accounts to link.
+                 */
+                institution?: string;
               }
 
               namespace Filters {
                 type AccountSubcategory = 'checking' | 'savings';
               }
 
+              interface ManualEntry {
+                /**
+                 * Settings for configuring manual entry of account details.
+                 */
+                mode?: ManualEntry.Mode;
+              }
+
+              namespace ManualEntry {
+                type Mode = 'automatic' | 'custom';
+              }
+
               type Permission =
                 | 'balances'
                 | 'ownership'
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';

package/types/Checkout/SessionsResource.d.ts

@@ -1684,6 +1684,11 @@ declare module 'stripe' {
              */
             reference?: string;
 
+            /**
+             * A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
+             */
+            reference_id?: string;
+
             /**
              * The risk correlation ID for an on-session payment using a saved PayPal payment method.
              */
@@ -1701,6 +1706,11 @@ declare module 'stripe' {
              * If `setup_future_usage` is already set and you are performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
              */
             setup_future_usage?: Stripe.Emptyable<Paypal.SetupFutureUsage>;
+
+            /**
+             * The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
+             */
+            subsellers?: Array<string>;
           }
 
           namespace Paypal {
@@ -1834,7 +1844,11 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';

package/types/ConfirmationTokens.d.ts

@@ -208,10 +208,14 @@ declare module 'stripe' {
 
         paypal?: PaymentMethodPreview.Paypal;
 
+        payto?: PaymentMethodPreview.Payto;
+
         pix?: PaymentMethodPreview.Pix;
 
         promptpay?: PaymentMethodPreview.Promptpay;
 
+        rechnung?: PaymentMethodPreview.Rechnung;
+
         revolut_pay?: PaymentMethodPreview.RevolutPay;
 
         sepa_debit?: PaymentMethodPreview.SepaDebit;
@@ -1210,6 +1214,11 @@ declare module 'stripe' {
         interface Paynow {}
 
         interface Paypal {
+          /**
+           * Uniquely identifies this particular PayPal account. You can use this attribute to check whether two PayPal accounts are the same.
+           */
+          fingerprint?: string | null;
+
           /**
            * Owner's email. Values are provided by PayPal directly
            * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
@@ -1220,12 +1229,58 @@ declare module 'stripe' {
            * PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
            */
           payer_id: string | null;
+
+          /**
+           * Owner's verified email. Values are verified or provided by PayPal directly
+           * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+           */
+          verified_email?: string | null;
+        }
+
+        interface Payto {
+          /**
+           * Bank-State-Branch number of the bank account.
+           */
+          bsb_number: string | null;
+
+          /**
+           * Last four digits of the bank account number.
+           */
+          last4: string | null;
+
+          /**
+           * The PayID alias for the bank account.
+           */
+          pay_id: string | null;
         }
 
         interface Pix {}
 
         interface Promptpay {}
 
+        interface Rechnung {
+          dob?: Rechnung.Dob;
+        }
+
+        namespace Rechnung {
+          interface Dob {
+            /**
+             * The day of birth, between 1 and 31.
+             */
+            day: number;
+
+            /**
+             * The month of birth, between 1 and 12.
+             */
+            month: number;
+
+            /**
+             * The four-digit year of birth.
+             */
+            year: number;
+          }
+        }
+
         interface RevolutPay {}
 
         interface SepaDebit {
@@ -1315,8 +1370,10 @@ declare module 'stripe' {
           | 'p24'
           | 'paynow'
           | 'paypal'
+          | 'payto'
           | 'pix'
           | 'promptpay'
+          | 'rechnung'
           | 'revolut_pay'
           | 'sepa_debit'
           | 'sofort'
@@ -1332,6 +1389,11 @@ declare module 'stripe' {
            */
           account_holder_type: UsBankAccount.AccountHolderType | null;
 
+          /**
+           * Account number of the bank account.
+           */
+          account_number?: string | null;
+
           /**
            * Account type: checkings or savings. Defaults to checking if omitted.
            */

package/types/Coupons.d.ts

@@ -113,7 +113,7 @@ declare module 'stripe' {
         amount_off: number;
       }
 
-      type Duration = 'forever' | 'once' | 'repeating';
+      type Duration = 'forever' | 'once' | 'repeating' | 'variable';
     }
 
     /**

package/types/CouponsResource.d.ts

@@ -86,7 +86,7 @@ declare module 'stripe' {
         amount_off: number;
       }
 
-      type Duration = 'forever' | 'once' | 'repeating';
+      type Duration = 'forever' | 'once' | 'repeating' | 'variable';
     }
 
     interface CouponRetrieveParams {

package/types/CreditNotes.d.ts

@@ -106,6 +106,10 @@ declare module 'stripe' {
        */
       pdf: string;
 
+      post_payment_amount?: number;
+
+      pre_payment_amount?: number;
+
       /**
        * Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
        */
@@ -116,6 +120,11 @@ declare module 'stripe' {
        */
       refund: string | Stripe.Refund | null;
 
+      /**
+       * Refunds related to this credit note.
+       */
+      refunds?: Array<CreditNote.Refund>;
+
       /**
        * The details of the cost of shipping, including the ShippingRate applied to the invoice.
        */
@@ -181,6 +190,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent).
+         */
+        amount_refunded: number;
+
+        /**
+         * ID of the refund.
+         */
+        refund: string | Stripe.Refund;
+      }
+
       interface ShippingCost {
         /**
          * Total shipping cost before any taxes are applied.

package/types/CreditNotesResource.d.ts

@@ -68,6 +68,11 @@ declare module 'stripe' {
        */
       refund_amount?: number;
 
+      /**
+       * Refunds to link to this credit note.
+       */
+      refunds?: Array<CreditNoteCreateParams.Refund>;
+
       /**
        * When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
        */
@@ -151,6 +156,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
+         */
+        amount_refunded?: number;
+
+        /**
+         * ID of an existing refund to link this credit note to.
+         */
+        refund?: string;
+      }
+
       interface ShippingCost {
         /**
          * The ID of the shipping rate to use for this order.
@@ -278,6 +295,11 @@ declare module 'stripe' {
        */
       refund_amount?: number;
 
+      /**
+       * Refunds to link to this credit note.
+       */
+      refunds?: Array<CreditNoteListPreviewLineItemsParams.Refund>;
+
       /**
        * When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
        */
@@ -361,6 +383,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
+         */
+        amount_refunded?: number;
+
+        /**
+         * ID of an existing refund to link this credit note to.
+         */
+        refund?: string;
+      }
+
       interface ShippingCost {
         /**
          * The ID of the shipping rate to use for this order.
@@ -435,6 +469,11 @@ declare module 'stripe' {
        */
       refund_amount?: number;
 
+      /**
+       * Refunds to link to this credit note.
+       */
+      refunds?: Array<CreditNotePreviewParams.Refund>;
+
       /**
        * When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
        */
@@ -518,6 +557,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
+         */
+        amount_refunded?: number;
+
+        /**
+         * ID of an existing refund to link this credit note to.
+         */
+        refund?: string;
+      }
+
       interface ShippingCost {
         /**
          * The ID of the shipping rate to use for this order.

package/types/CustomersResource.d.ts

@@ -818,8 +818,10 @@ declare module 'stripe' {
         | 'p24'
         | 'paynow'
         | 'paypal'
+        | 'payto'
         | 'pix'
         | 'promptpay'
+        | 'rechnung'
         | 'revolut_pay'
         | 'sepa_debit'
         | 'sofort'

package/types/Disputes.d.ts

@@ -45,6 +45,11 @@ declare module 'stripe' {
        */
       currency: string;
 
+      /**
+       * List of eligibility types that are included in `enhanced_evidence`.
+       */
+      enhanced_eligibility_types?: Array<'visa_compelling_evidence_3'>;
+
       evidence: Dispute.Evidence;
 
       evidence_details: Dispute.EvidenceDetails;
@@ -154,6 +159,8 @@ declare module 'stripe' {
          */
         duplicate_charge_id: string | null;
 
+        enhanced_evidence?: Evidence.EnhancedEvidence;
+
         /**
          * A description of the product or service that was sold.
          */
@@ -225,12 +232,126 @@ declare module 'stripe' {
         uncategorized_text: string | null;
       }
 
+      namespace Evidence {
+        interface EnhancedEvidence {
+          visa_compelling_evidence_3?: EnhancedEvidence.VisaCompellingEvidence3;
+        }
+
+        namespace EnhancedEvidence {
+          interface VisaCompellingEvidence3 {
+            /**
+             * Disputed transaction details for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            disputed_transaction: VisaCompellingEvidence3.DisputedTransaction | null;
+
+            /**
+             * List of exactly two prior undisputed transaction objects for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            prior_undisputed_transactions: Array<
+              VisaCompellingEvidence3.PriorUndisputedTransaction
+            >;
+          }
+
+          namespace VisaCompellingEvidence3 {
+            interface DisputedTransaction {
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id: string | null;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address: string | null;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip: string | null;
+
+              /**
+               * Categorization of disputed payment.
+               */
+              merchandise_or_services: DisputedTransaction.MerchandiseOrServices | null;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description: string | null;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address: Stripe.Address | null;
+            }
+
+            namespace DisputedTransaction {
+              type MerchandiseOrServices = 'merchandise' | 'services';
+            }
+
+            interface PriorUndisputedTransaction {
+              /**
+               * Stripe charge ID for the Visa Compelling Evidence 3.0 eligible prior charge.
+               */
+              charge: string;
+
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint: string | null;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id: string | null;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address: string | null;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip: string | null;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description: string | null;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address: Stripe.Address | null;
+            }
+          }
+        }
+      }
+
       interface EvidenceDetails {
         /**
          * Date by which evidence must be submitted in order to successfully challenge dispute. Will be 0 if the customer's bank or credit card company doesn't allow a response for this particular dispute.
          */
         due_by: number | null;
 
+        enhanced_eligibility?: EvidenceDetails.EnhancedEligibility;
+
         /**
          * Whether evidence has been staged for this dispute.
          */
@@ -247,6 +368,43 @@ declare module 'stripe' {
         submission_count: number;
       }
 
+      namespace EvidenceDetails {
+        interface EnhancedEligibility {
+          visa_compelling_evidence_3?: EnhancedEligibility.VisaCompellingEvidence3;
+        }
+
+        namespace EnhancedEligibility {
+          interface VisaCompellingEvidence3 {
+            /**
+             * List of actions required to qualify dispute for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            required_actions: Array<VisaCompellingEvidence3.RequiredAction>;
+
+            /**
+             * Visa Compelling Evidence 3.0 eligibility status.
+             */
+            status: VisaCompellingEvidence3.Status;
+          }
+
+          namespace VisaCompellingEvidence3 {
+            type RequiredAction =
+              | 'missing_customer_identifiers'
+              | 'missing_disputed_transaction_description'
+              | 'missing_merchandise_or_services'
+              | 'missing_prior_undisputed_transaction_description'
+              | 'missing_prior_undisputed_transactions';
+
+            type Status =
+              | 'accepted'
+              | 'not_qualified'
+              | 'partner_rejected'
+              | 'qualified'
+              | 'requires_action'
+              | 'submitted';
+          }
+        }
+      }
+
       interface PaymentMethodDetails {
         card?: PaymentMethodDetails.Card;
 

package/types/DisputesResource.d.ts

@@ -98,6 +98,11 @@ declare module 'stripe' {
          */
         duplicate_charge_id?: string;
 
+        /**
+         * Additional evidence for qualifying evidence programs.
+         */
+        enhanced_evidence?: Stripe.Emptyable<Evidence.EnhancedEvidence>;
+
         /**
          * A description of the product or service that was sold. Has a maximum character count of 20,000.
          */
@@ -168,6 +173,121 @@ declare module 'stripe' {
          */
         uncategorized_text?: string;
       }
+
+      namespace Evidence {
+        interface EnhancedEvidence {
+          /**
+           * Evidence provided for Visa Compelling Evidence 3.0 evidence submission.
+           */
+          visa_compelling_evidence_3?: EnhancedEvidence.VisaCompellingEvidence3;
+        }
+
+        namespace EnhancedEvidence {
+          interface VisaCompellingEvidence3 {
+            /**
+             * Disputed transaction details for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            disputed_transaction?: VisaCompellingEvidence3.DisputedTransaction;
+
+            /**
+             * List of exactly two prior undisputed transaction objects for Visa Compelling Evidence 3.0 evidence submission.
+             */
+            prior_undisputed_transactions?: Array<
+              VisaCompellingEvidence3.PriorUndisputedTransaction
+            >;
+          }
+
+          namespace VisaCompellingEvidence3 {
+            interface DisputedTransaction {
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id?: Stripe.Emptyable<string>;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address?: Stripe.Emptyable<string>;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip?: Stripe.Emptyable<string>;
+
+              /**
+               * Categorization of disputed payment.
+               */
+              merchandise_or_services?: DisputedTransaction.MerchandiseOrServices;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description?: Stripe.Emptyable<string>;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address?: Stripe.AddressParam;
+            }
+
+            namespace DisputedTransaction {
+              type MerchandiseOrServices = 'merchandise' | 'services';
+            }
+
+            interface PriorUndisputedTransaction {
+              /**
+               * Stripe charge ID for the Visa Compelling Evidence 3.0 eligible prior charge.
+               */
+              charge: string;
+
+              /**
+               * User Account ID used to log into business platform. Must be recognizable by the user.
+               */
+              customer_account_id?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
+               */
+              customer_device_fingerprint?: Stripe.Emptyable<string>;
+
+              /**
+               * Unique identifier of the cardholder's device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
+               */
+              customer_device_id?: Stripe.Emptyable<string>;
+
+              /**
+               * The email address of the customer.
+               */
+              customer_email_address?: Stripe.Emptyable<string>;
+
+              /**
+               * The IP address that the customer used when making the purchase.
+               */
+              customer_purchase_ip?: Stripe.Emptyable<string>;
+
+              /**
+               * A description of the product or service that was sold.
+               */
+              product_description?: Stripe.Emptyable<string>;
+
+              /**
+               * The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
+               */
+              shipping_address?: Stripe.AddressParam;
+            }
+          }
+        }
+      }
     }
 
     interface DisputeListParams extends PaginationParams {