stripe 18.2.0-beta.1 → 18.2.1

package/types/ConfirmationTokens.d.ts

@@ -211,8 +211,6 @@ declare module 'stripe' {
          */
         customer: string | Stripe.Customer | null;
 
-        customer_account?: string | null;
-
         customer_balance?: PaymentMethodPreview.CustomerBalance;
 
         eps?: PaymentMethodPreview.Eps;
@@ -221,12 +219,8 @@ declare module 'stripe' {
 
         giropay?: PaymentMethodPreview.Giropay;
 
-        gopay?: PaymentMethodPreview.Gopay;
-
         grabpay?: PaymentMethodPreview.Grabpay;
 
-        id_bank_transfer?: PaymentMethodPreview.IdBankTransfer;
-
         ideal?: PaymentMethodPreview.Ideal;
 
         interac_present?: PaymentMethodPreview.InteracPresent;
@@ -241,8 +235,6 @@ declare module 'stripe' {
 
         link?: PaymentMethodPreview.Link;
 
-        mb_way?: PaymentMethodPreview.MbWay;
-
         mobilepay?: PaymentMethodPreview.Mobilepay;
 
         multibanco?: PaymentMethodPreview.Multibanco;
@@ -263,16 +255,10 @@ declare module 'stripe' {
 
         paypal?: PaymentMethodPreview.Paypal;
 
-        payto?: PaymentMethodPreview.Payto;
-
         pix?: PaymentMethodPreview.Pix;
 
         promptpay?: PaymentMethodPreview.Promptpay;
 
-        qris?: PaymentMethodPreview.Qris;
-
-        rechnung?: PaymentMethodPreview.Rechnung;
-
         revolut_pay?: PaymentMethodPreview.RevolutPay;
 
         samsung_pay?: PaymentMethodPreview.SamsungPay;
@@ -281,12 +267,8 @@ declare module 'stripe' {
 
         sepa_debit?: PaymentMethodPreview.SepaDebit;
 
-        shopeepay?: PaymentMethodPreview.Shopeepay;
-
         sofort?: PaymentMethodPreview.Sofort;
 
-        stripe_balance?: PaymentMethodPreview.StripeBalance;
-
         swish?: PaymentMethodPreview.Swish;
 
         twint?: PaymentMethodPreview.Twint;
@@ -305,11 +287,6 @@ 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.
            */
@@ -778,7 +755,7 @@ declare module 'stripe' {
 
           interface Networks {
             /**
-             * All networks available for selection via [payment_method_options.card.network](https://stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
+             * All networks available for selection via [payment_method_options.card.network](https://docs.stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
              */
             available: Array<string>;
 
@@ -978,7 +955,7 @@ declare module 'stripe' {
         namespace CardPresent {
           interface Networks {
             /**
-             * All networks available for selection via [payment_method_options.card.network](https://stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
+             * All networks available for selection via [payment_method_options.card.network](https://docs.stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
              */
             available: Array<string>;
 
@@ -1114,24 +1091,8 @@ 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`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
@@ -1260,7 +1221,7 @@ declare module 'stripe' {
         namespace InteracPresent {
           interface Networks {
             /**
-             * All networks available for selection via [payment_method_options.card.network](https://stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
+             * All networks available for selection via [payment_method_options.card.network](https://docs.stripe.com/api/payment_intents/confirm#confirm_payment_intent-payment_method_options-card-network).
              */
             available: Array<string>;
 
@@ -1359,8 +1320,6 @@ declare module 'stripe' {
           persistent_token?: string;
         }
 
-        interface MbWay {}
-
         interface Mobilepay {}
 
         interface Multibanco {}
@@ -1369,7 +1328,7 @@ declare module 'stripe' {
           /**
            * Uniquely identifies this particular Naver Pay account. You can use this attribute to check whether two Naver Pay accounts are the same.
            */
-          buyer_id?: string | null;
+          buyer_id: string | null;
 
           /**
            * Whether to fund this transaction with Naver Pay points or a card.
@@ -1464,11 +1423,6 @@ 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.
@@ -1479,60 +1433,12 @@ 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 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 {}
@@ -1585,8 +1491,6 @@ declare module 'stripe' {
           }
         }
 
-        interface Shopeepay {}
-
         interface Sofort {
           /**
            * Two-letter ISO code representing the country the bank account is located in.
@@ -1594,22 +1498,6 @@ 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 {}
@@ -1634,9 +1522,7 @@ declare module 'stripe' {
           | 'eps'
           | 'fpx'
           | 'giropay'
-          | 'gopay'
           | 'grabpay'
-          | 'id_bank_transfer'
           | 'ideal'
           | 'interac_present'
           | 'kakao_pay'
@@ -1644,7 +1530,6 @@ declare module 'stripe' {
           | 'konbini'
           | 'kr_card'
           | 'link'
-          | 'mb_way'
           | 'mobilepay'
           | 'multibanco'
           | 'naver_pay'
@@ -1655,18 +1540,13 @@ declare module 'stripe' {
           | 'payco'
           | 'paynow'
           | 'paypal'
-          | 'payto'
           | 'pix'
           | 'promptpay'
-          | 'qris'
-          | 'rechnung'
           | 'revolut_pay'
           | 'samsung_pay'
           | 'satispay'
           | 'sepa_debit'
-          | 'shopeepay'
           | 'sofort'
-          | 'stripe_balance'
           | 'swish'
           | 'twint'
           | 'us_bank_account'
@@ -1679,11 +1559,6 @@ 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/CountrySpecs.d.ts

@@ -8,7 +8,7 @@ declare module 'stripe' {
      * Country Specs API makes these rules available to your integration.
      *
      * You can also view the information from this API call as [an online
-     * guide](https://stripe.com/docs/connect/required-verification-information).
+     * guide](https://docs.stripe.com/docs/connect/required-verification-information).
      */
     interface CountrySpec {
       /**

package/types/Coupons.d.ts

@@ -87,21 +87,11 @@ 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.
        */
@@ -124,29 +114,6 @@ 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 {
-        interface Configuration {}
-      }
-
-      type Type = 'amount_off' | 'percent_off' | 'script';
     }
 
     /**

package/types/CouponsResource.d.ts

@@ -69,11 +69,6 @@ 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 {
@@ -92,22 +87,6 @@ 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 {
-        interface Configuration {}
-      }
     }
 
     interface CouponRetrieveParams {

package/types/CreditNoteLineItems.d.ts

@@ -56,11 +56,6 @@ 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.
        */
@@ -186,18 +181,6 @@ 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,11 +43,6 @@ 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.
        */
@@ -111,9 +106,15 @@ declare module 'stripe' {
        */
       pdf: string;
 
-      post_payment_amount?: number;
+      /**
+       * The amount of the credit note that was refunded to the customer, credited to the customer's balance, credited outside of Stripe, or any combination thereof.
+       */
+      post_payment_amount: number;
 
-      pre_payment_amount?: number;
+      /**
+       * The amount of the credit note by which the invoice's `amount_remaining` and `amount_due` were reduced.
+       */
+      pre_payment_amount: number;
 
       /**
        * The pretax credit amounts (ex: discount, credit grants, etc) for all line items.
@@ -270,9 +271,9 @@ declare module 'stripe' {
           amount: number;
 
           /**
-           * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
+           * Tax rates can be applied to [invoices](https://docs.stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://docs.stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://docs.stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
            *
-           * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
+           * Related guide: [Tax rates](https://docs.stripe.com/billing/taxes/tax-rates)
            */
           rate: Stripe.TaxRate;
 
@@ -367,7 +368,7 @@ declare module 'stripe' {
         }
       }
 
-      type Type = 'post_payment' | 'pre_payment';
+      type Type = 'mixed' | 'post_payment' | 'pre_payment';
     }
   }
 }

package/types/CreditNotesResource.d.ts

@@ -206,11 +206,6 @@ 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.
        */
@@ -576,20 +571,19 @@ declare module 'stripe' {
 
     class CreditNotesResource {
       /**
-       * Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces
-       * its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result
-       * in any combination of the following:
+       * Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero.
+       * This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following:
        *
        *
-       * Refund: create a new refund (using refund_amount) or link an existing refund (using refund).
+       * Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds).
        * Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
        * Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
        *
        *
-       * For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total.
+       * The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount.
        *
-       * You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount
-       * or post_payment_credit_notes_amount depending on its status at the time of credit note creation.
+       * You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
+       * post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.
        */
       create(
         params: CreditNoteCreateParams,
@@ -657,7 +651,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.CreditNote>>;
 
       /**
-       * Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+       * Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
        */
       voidCreditNote(
         id: string,

package/types/CustomerBalanceTransactions.d.ts

@@ -51,8 +51,6 @@ 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,8 +38,6 @@ 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

@@ -6,9 +6,9 @@ declare module 'stripe' {
      * A Customer Session allows you to grant Stripe's frontend SDKs (like Stripe.js) client-side access
      * control over a Customer.
      *
-     * Related guides: [Customer Session with the Payment Element](https://stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
-     * [Customer Session with the Pricing Table](https://stripe.com/payments/checkout/pricing-table#customer-session),
-     * [Customer Session with the Buy Button](https://stripe.com/payment-links/buy-button#pass-an-existing-customer).
+     * Related guides: [Customer Session with the Payment Element](https://docs.stripe.com/payments/accept-a-payment-deferred?platform=web&type=payment#save-payment-methods),
+     * [Customer Session with the Pricing Table](https://docs.stripe.com/payments/checkout/pricing-table#customer-session),
+     * [Customer Session with the Buy Button](https://docs.stripe.com/payment-links/buy-button#pass-an-existing-customer).
      */
     interface CustomerSession {
       /**
@@ -38,11 +38,6 @@ 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.
        */

package/types/CustomerSessionsResource.d.ts

@@ -11,12 +11,7 @@ declare module 'stripe' {
       /**
        * The ID of an existing customer for which to create the Customer Session.
        */
-      customer?: string;
-
-      /**
-       * The ID of an existing Account for which to create the Customer Session.
-       */
-      customer_account?: string;
+      customer: string;
 
       /**
        * Specifies which fields in the response should be expanded.

package/types/Customers.d.ts

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