stripe 20.0.0 → 20.1.0-beta.1

package/types/ConfirmationTokens.d.ts

@@ -217,6 +217,8 @@ declare module 'stripe' {
          */
         customer: string | Stripe.Customer | null;
 
+        customer_account?: string | null;
+
         customer_balance?: PaymentMethodPreview.CustomerBalance;
 
         eps?: PaymentMethodPreview.Eps;
@@ -225,8 +227,12 @@ declare module 'stripe' {
 
         giropay?: PaymentMethodPreview.Giropay;
 
+        gopay?: PaymentMethodPreview.Gopay;
+
         grabpay?: PaymentMethodPreview.Grabpay;
 
+        id_bank_transfer?: PaymentMethodPreview.IdBankTransfer;
+
         ideal?: PaymentMethodPreview.Ideal;
 
         interac_present?: PaymentMethodPreview.InteracPresent;
@@ -263,10 +269,18 @@ declare module 'stripe' {
 
         paypal?: PaymentMethodPreview.Paypal;
 
+        paypay?: PaymentMethodPreview.Paypay;
+
+        payto?: PaymentMethodPreview.Payto;
+
         pix?: PaymentMethodPreview.Pix;
 
         promptpay?: PaymentMethodPreview.Promptpay;
 
+        qris?: PaymentMethodPreview.Qris;
+
+        rechnung?: PaymentMethodPreview.Rechnung;
+
         revolut_pay?: PaymentMethodPreview.RevolutPay;
 
         samsung_pay?: PaymentMethodPreview.SamsungPay;
@@ -275,8 +289,12 @@ declare module 'stripe' {
 
         sepa_debit?: PaymentMethodPreview.SepaDebit;
 
+        shopeepay?: PaymentMethodPreview.Shopeepay;
+
         sofort?: PaymentMethodPreview.Sofort;
 
+        stripe_balance?: PaymentMethodPreview.StripeBalance;
+
         swish?: PaymentMethodPreview.Swish;
 
         twint?: PaymentMethodPreview.Twint;
@@ -295,6 +313,11 @@ declare module 'stripe' {
 
       namespace PaymentMethodPreview {
         interface AcssDebit {
+          /**
+           * Account number of the bank account.
+           */
+          account_number?: string | null;
+
           /**
            * Name of the bank associated with the bank account.
            */
@@ -1101,8 +1124,24 @@ declare module 'stripe' {
 
         interface Giropay {}
 
+        interface Gopay {}
+
         interface Grabpay {}
 
+        interface IdBankTransfer {
+          bank: IdBankTransfer.Bank | null;
+
+          bank_code: string | null;
+
+          bank_name: string | null;
+
+          display_name: string | null;
+        }
+
+        namespace IdBankTransfer {
+          type Bank = 'bca' | 'bni' | 'bri' | 'cimb' | 'permata';
+        }
+
         interface Ideal {
           /**
            * The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `finom`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
@@ -1439,6 +1478,11 @@ declare module 'stripe' {
            */
           country: string | null;
 
+          /**
+           * 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.
@@ -1449,12 +1493,62 @@ 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 Paypay {}
+
+        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 Qris {}
+
+        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 SamsungPay {}
@@ -1507,6 +1601,8 @@ declare module 'stripe' {
           }
         }
 
+        interface Shopeepay {}
+
         interface Sofort {
           /**
            * Two-letter ISO code representing the country the bank account is located in.
@@ -1514,6 +1610,22 @@ declare module 'stripe' {
           country: string | null;
         }
 
+        interface StripeBalance {
+          /**
+           * The connected account ID whose Stripe balance to use as the source of payment
+           */
+          account?: string | null;
+
+          /**
+           * The [source_type](https://docs.stripe.com/api/balance/balance_object#balance_object-available-source_types) of the balance
+           */
+          source_type: StripeBalance.SourceType;
+        }
+
+        namespace StripeBalance {
+          type SourceType = 'bank_account' | 'card' | 'fpx';
+        }
+
         interface Swish {}
 
         interface Twint {}
@@ -1540,7 +1652,9 @@ declare module 'stripe' {
           | 'eps'
           | 'fpx'
           | 'giropay'
+          | 'gopay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'interac_present'
           | 'kakao_pay'
@@ -1559,13 +1673,19 @@ declare module 'stripe' {
           | 'payco'
           | 'paynow'
           | 'paypal'
+          | 'paypay'
+          | 'payto'
           | 'pix'
           | 'promptpay'
+          | 'qris'
+          | 'rechnung'
           | 'revolut_pay'
           | 'samsung_pay'
           | 'satispay'
           | 'sepa_debit'
+          | 'shopeepay'
           | 'sofort'
+          | 'stripe_balance'
           | 'swish'
           | 'twint'
           | 'us_bank_account'
@@ -1578,6 +1698,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

@@ -87,11 +87,21 @@ declare module 'stripe' {
        */
       redeem_by: number | null;
 
+      /**
+       * Configuration of the [script](https://docs.stripe.com/billing/subscriptions/script-coupons) used to calculate the discount.
+       */
+      script?: Coupon.Script | null;
+
       /**
        * Number of times this coupon has been applied to a customer.
        */
       times_redeemed: number;
 
+      /**
+       * One of `amount_off`, `percent_off`, or `script`. Describes the type of coupon logic used to calculate the discount.
+       */
+      type?: Coupon.Type | null;
+
       /**
        * Taking account of the above properties, whether this coupon can still be applied to a customer.
        */
@@ -114,6 +124,31 @@ declare module 'stripe' {
       }
 
       type Duration = 'forever' | 'once' | 'repeating';
+
+      interface Script {
+        /**
+         * The configuration values of the script. The keys and values are specific to the script implementation.
+         */
+        configuration: Script.Configuration;
+
+        /**
+         * The name of the script used to calculate the discount.
+         */
+        display_name: string;
+
+        /**
+         * The script implementation ID for this coupon.
+         */
+        id: string;
+      }
+
+      namespace Script {
+        type Configuration = {
+          [key: string]: unknown;
+        };
+      }
+
+      type Type = 'amount_off' | 'percent_off' | 'script';
     }
 
     /**

package/types/CouponsResource.d.ts

@@ -69,6 +69,11 @@ declare module 'stripe' {
        * Unix timestamp specifying the last time at which the coupon can be redeemed. After the redeem_by date, the coupon can no longer be applied to new customers.
        */
       redeem_by?: number;
+
+      /**
+       * Configuration of the [script](https://docs.stripe.com/billing/subscriptions/script-coupons) used to calculate the discount.
+       */
+      script?: CouponCreateParams.Script;
     }
 
     namespace CouponCreateParams {
@@ -87,6 +92,24 @@ declare module 'stripe' {
       }
 
       type Duration = 'forever' | 'once' | 'repeating';
+
+      interface Script {
+        /**
+         * The configuration values of the script. The keys and values are specific to the script implementation.
+         */
+        configuration: Script.Configuration;
+
+        /**
+         * The script implementation ID for this coupon.
+         */
+        id: string;
+      }
+
+      namespace Script {
+        type Configuration = {
+          [key: string]: unknown;
+        };
+      }
     }
 
     interface CouponRetrieveParams {

package/types/CreditNoteLineItems.d.ts

@@ -56,6 +56,11 @@ declare module 'stripe' {
        */
       quantity: number | null;
 
+      /**
+       * The tax calculation identifiers of the line item.
+       */
+      tax_calculation_reference?: CreditNoteLineItem.TaxCalculationReference | null;
+
       /**
        * The tax rates which apply to the line item.
        */
@@ -181,6 +186,18 @@ declare module 'stripe' {
         }
       }
 
+      interface TaxCalculationReference {
+        /**
+         * The calculation identifier for tax calculation response.
+         */
+        calculation_id: string | null;
+
+        /**
+         * The calculation identifier for tax calculation response line item.
+         */
+        calculation_item_id: string | null;
+      }
+
       type Type = 'custom_line_item' | 'invoice_line_item';
     }
   }

package/types/CreditNotes.d.ts

@@ -43,6 +43,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer;
 
+      /**
+       * ID of the account.
+       */
+      customer_account?: string | null;
+
       /**
        * Customer balance transaction related to this credit note.
        */

package/types/CreditNotesResource.d.ts

@@ -232,6 +232,11 @@ declare module 'stripe' {
        */
       customer?: string;
 
+      /**
+       * Only return credit notes for the account specified by this account ID.
+       */
+      customer_account?: string;
+
       /**
        * Specifies which fields in the response should be expanded.
        */

package/types/CustomerBalanceTransactions.d.ts

@@ -51,6 +51,8 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer;
 
+      customer_account?: string | null;
+
       /**
        * An arbitrary string attached to the object. Often useful for displaying to users.
        */

package/types/CustomerCashBalanceTransactions.d.ts

@@ -38,6 +38,8 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer;
 
+      customer_account?: string | null;
+
       /**
        * The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
        */

package/types/CustomerSessions.d.ts

@@ -38,6 +38,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer;
 
+      /**
+       * The Account that the Customer Session was created for.
+       */
+      customer_account?: string | null;
+
       /**
        * The timestamp at which this Customer Session will expire.
        */
@@ -75,6 +80,11 @@ declare module 'stripe' {
          * This hash contains whether the pricing table is enabled.
          */
         pricing_table: Components.PricingTable;
+
+        /**
+         * This hash contains whether the Tax ID Element is enabled and the features it supports.
+         */
+        tax_id_element?: Components.TaxIdElement;
       }
 
       namespace Components {
@@ -272,6 +282,42 @@ declare module 'stripe' {
            */
           enabled: boolean;
         }
+
+        interface TaxIdElement {
+          /**
+           * Whether the Tax ID Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Tax ID Element supports certain features.
+           */
+          features: TaxIdElement.Features | null;
+        }
+
+        namespace TaxIdElement {
+          interface Features {
+            /**
+             * Controls whether the Tax ID Element displays saved tax IDs for the customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, the Tax ID Element will show existing tax IDs associated with the customer, allowing them to select from previously saved tax identification numbers.
+             */
+            tax_id_redisplay: Features.TaxIdRedisplay;
+
+            /**
+             * Controls whether the Tax ID Element allows merchants to save new tax IDs for their customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, customers can enter and save new tax identification numbers during the payment flow, which will be stored securely and associated with their customer object for future use.
+             */
+            tax_id_save: Features.TaxIdSave;
+          }
+
+          namespace Features {
+            type TaxIdRedisplay = 'disabled' | 'enabled';
+
+            type TaxIdSave = 'disabled' | 'enabled';
+          }
+        }
       }
     }
   }

package/types/CustomerSessionsResource.d.ts

@@ -11,7 +11,12 @@ declare module 'stripe' {
       /**
        * The ID of an existing customer for which to create the Customer Session.
        */
-      customer: string;
+      customer?: string;
+
+      /**
+       * The ID of an existing Account for which to create the Customer Session.
+       */
+      customer_account?: string;
 
       /**
        * Specifies which fields in the response should be expanded.
@@ -45,6 +50,11 @@ declare module 'stripe' {
          * Configuration for the pricing table.
          */
         pricing_table?: Components.PricingTable;
+
+        /**
+         * Configuration for the Tax ID Element.
+         */
+        tax_id_element?: Components.TaxIdElement;
       }
 
       namespace Components {
@@ -242,6 +252,42 @@ declare module 'stripe' {
            */
           enabled: boolean;
         }
+
+        interface TaxIdElement {
+          /**
+           * Whether the Tax ID Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Tax ID Element supports certain features.
+           */
+          features?: TaxIdElement.Features;
+        }
+
+        namespace TaxIdElement {
+          interface Features {
+            /**
+             * Controls whether the Tax ID Element displays saved tax IDs for the customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, the Tax ID Element will show existing tax IDs associated with the customer, allowing them to select from previously saved tax identification numbers.
+             */
+            tax_id_redisplay?: Features.TaxIdRedisplay;
+
+            /**
+             * Controls whether the Tax ID Element allows merchants to save new tax IDs for their customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, customers can enter and save new tax identification numbers during the payment flow, which will be stored securely and associated with their customer object for future use.
+             */
+            tax_id_save?: Features.TaxIdSave;
+          }
+
+          namespace Features {
+            type TaxIdRedisplay = 'disabled' | 'enabled';
+
+            type TaxIdSave = 'disabled' | 'enabled';
+          }
+        }
       }
     }
 

package/types/Customers.d.ts

@@ -47,6 +47,8 @@ declare module 'stripe' {
        */
       currency?: string | null;
 
+      customer_account?: string | null;
+
       /**
        * ID of the default payment source for the customer.
        *

package/types/CustomersResource.d.ts

@@ -906,7 +906,9 @@ declare module 'stripe' {
         | 'eps'
         | 'fpx'
         | 'giropay'
+        | 'gopay'
         | 'grabpay'
+        | 'id_bank_transfer'
         | 'ideal'
         | 'kakao_pay'
         | 'klarna'
@@ -924,13 +926,19 @@ declare module 'stripe' {
         | 'payco'
         | 'paynow'
         | 'paypal'
+        | 'paypay'
+        | 'payto'
         | 'pix'
         | 'promptpay'
+        | 'qris'
+        | 'rechnung'
         | 'revolut_pay'
         | 'samsung_pay'
         | 'satispay'
         | 'sepa_debit'
+        | 'shopeepay'
         | 'sofort'
+        | 'stripe_balance'
         | 'swish'
         | 'twint'
         | 'us_bank_account'

package/types/Discounts.d.ts

@@ -26,6 +26,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+      /**
+       * The ID of the account associated with this discount.
+       */
+      customer_account?: string | null;
+
       /**
        * Always true for a deleted object
        */
@@ -105,6 +110,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+      /**
+       * The ID of the account associated with this discount.
+       */
+      customer_account?: string | null;
+
       /**
        * Always true for a deleted object
        */

package/types/Disputes.d.ts

@@ -54,6 +54,11 @@ declare module 'stripe' {
 
       evidence_details: Dispute.EvidenceDetails;
 
+      /**
+       * Intended submission method for the dispute.
+       */
+      intended_submission_method?: Dispute.IntendedSubmissionMethod | null;
+
       /**
        * If true, it's still possible to refund the disputed payment. After the payment has been fully refunded, no further funds are withdrawn from your Stripe account as a result of this dispute.
        */
@@ -86,6 +91,8 @@ declare module 'stripe' {
        */
       reason: string;
 
+      smart_disputes?: Dispute.SmartDisputes;
+
       /**
        * The current status of a dispute. Possible values include:`warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, `lost`, or `prevented`.
        */
@@ -379,6 +386,11 @@ declare module 'stripe' {
          * The number of times evidence has been submitted. Typically, you may only submit evidence once.
          */
         submission_count: number;
+
+        /**
+         * Whether the dispute was submitted manually, with Smart Disputes, or not submitted.
+         */
+        submission_method?: EvidenceDetails.SubmissionMethod;
       }
 
       namespace EvidenceDetails {
@@ -423,8 +435,16 @@ declare module 'stripe' {
             type Status = 'fee_acknowledged' | 'requires_fee_acknowledgement';
           }
         }
+
+        type SubmissionMethod = 'manual' | 'not_submitted' | 'smart_disputes';
       }
 
+      type IntendedSubmissionMethod =
+        | 'manual'
+        | 'prefer_manual'
+        | 'prefer_smart_disputes'
+        | 'smart_disputes';
+
       interface PaymentMethodDetails {
         amazon_pay?: PaymentMethodDetails.AmazonPay;
 
@@ -505,6 +525,26 @@ declare module 'stripe' {
         type Type = 'amazon_pay' | 'card' | 'klarna' | 'paypal';
       }
 
+      interface SmartDisputes {
+        /**
+         * Evidence that could be provided to improve the SmartDisputes packet
+         */
+        recommended_evidence: Array<Array<string>> | null;
+
+        /**
+         * Smart Disputes auto representment packet availability status.
+         */
+        status: SmartDisputes.Status;
+      }
+
+      namespace SmartDisputes {
+        type Status =
+          | 'available'
+          | 'processing'
+          | 'requires_evidence'
+          | 'unavailable';
+      }
+
       type Status =
         | 'lost'
         | 'needs_response'