stripe 18.0.0 → 18.1.0-beta.1

package/types/Invoices.d.ts

@@ -109,6 +109,11 @@ declare module 'stripe' {
        */
       amount_shipping: number;
 
+      /**
+       * List of expected payments and corresponding due dates. This value will be null for invoices where collection_method=charge_automatically.
+       */
+      amounts_due?: Array<Invoice.AmountsDue> | null;
+
       /**
        * ID of the Connect Application that created the invoice.
        */
@@ -183,6 +188,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+      /**
+       * The ID of the account who will be billed.
+       */
+      customer_account?: string | null;
+
       /**
        * The customer's address. Until the invoice is finalized, this field will equal `customer.address`. Once the invoice is finalized, this field will no longer be updated.
        */
@@ -218,6 +228,11 @@ declare module 'stripe' {
        */
       customer_tax_ids?: Array<Invoice.CustomerTaxId> | null;
 
+      /**
+       * The margins applied to the invoice. Can be overridden by line item `margins`. Use `expand[]=default_margins` to expand each margin.
+       */
+      default_margins?: Array<string | Stripe.Margin> | null;
+
       /**
        * ID of the default payment method for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription's default payment method, if any, or to the default payment method in the customer's invoice settings.
        */
@@ -426,6 +441,11 @@ declare module 'stripe' {
        */
       total_excluding_tax: number | null;
 
+      /**
+       * The aggregate amounts calculated per margin across all line items.
+       */
+      total_margin_amounts?: Array<Invoice.TotalMarginAmount> | null;
+
       /**
        * Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice. This is a combined list of total_pretax_credit_amounts across all invoice line items.
        */
@@ -445,6 +465,52 @@ declare module 'stripe' {
     }
 
     namespace Invoice {
+      interface AmountsDue {
+        /**
+         * Incremental amount due for this payment in cents (or local equivalent).
+         */
+        amount: number;
+
+        /**
+         * The amount in cents (or local equivalent) that was paid for this payment.
+         */
+        amount_paid: number;
+
+        /**
+         * The difference between the payment's amount and amount_paid, in cents (or local equivalent).
+         */
+        amount_remaining: number;
+
+        /**
+         * Number of days from when invoice is finalized until the payment is due.
+         */
+        days_until_due: number | null;
+
+        /**
+         * An arbitrary string attached to the object. Often useful for displaying to users.
+         */
+        description: string | null;
+
+        /**
+         * Date on which a payment plan's payment is due.
+         */
+        due_date: number | null;
+
+        /**
+         * Timestamp when the payment was paid.
+         */
+        paid_at: number | null;
+
+        /**
+         * The status of the payment, one of `open`, `paid`, or `past_due`
+         */
+        status: AmountsDue.Status;
+      }
+
+      namespace AmountsDue {
+        type Status = 'open' | 'paid' | 'past_due';
+      }
+
       interface AutomaticTax {
         /**
          * If Stripe disabled automatic tax, this enum describes why.
@@ -461,6 +527,11 @@ declare module 'stripe' {
          */
         liability: AutomaticTax.Liability | null;
 
+        /**
+         * The tax provider powering automatic tax.
+         */
+        provider?: string | null;
+
         /**
          * The status of the most recent automated tax calculation for this invoice.
          */
@@ -862,12 +933,16 @@ declare module 'stripe' {
           | 'email_invalid'
           | 'expired_card'
           | 'financial_connections_account_inactive'
+          | 'financial_connections_institution_unavailable'
           | 'financial_connections_no_successful_transaction_refresh'
           | 'forwarding_api_inactive'
           | 'forwarding_api_invalid_parameter'
           | 'forwarding_api_retryable_upstream_error'
           | 'forwarding_api_upstream_connection_error'
           | 'forwarding_api_upstream_connection_timeout'
+          | 'gift_card_balance_insufficient'
+          | 'gift_card_code_exists'
+          | 'gift_card_inactive'
           | 'idempotency_key_in_use'
           | 'incorrect_address'
           | 'incorrect_cvc'
@@ -957,6 +1032,7 @@ declare module 'stripe' {
           | 'return_intent_already_processed'
           | 'routing_number_invalid'
           | 'secret_key_required'
+          | 'sensitive_data_access_expired'
           | 'sepa_unsupported_account'
           | 'setup_attempt_failed'
           | 'setup_intent_authentication_failure'
@@ -975,6 +1051,7 @@ declare module 'stripe' {
           | 'taxes_calculation_failed'
           | 'terminal_location_country_unsupported'
           | 'terminal_reader_busy'
+          | 'terminal_reader_collected_data_invalid'
           | 'terminal_reader_hardware_fault'
           | 'terminal_reader_invalid_location_for_activation'
           | 'terminal_reader_invalid_location_for_payment'
@@ -987,7 +1064,9 @@ declare module 'stripe' {
           | 'token_in_use'
           | 'transfer_source_balance_parameters_mismatch'
           | 'transfers_not_allowed'
-          | 'url_invalid';
+          | 'url_invalid'
+          | 'v2_account_disconnection_unsupported'
+          | 'v2_account_missing_configuration';
 
         type Type =
           | 'api_error'
@@ -1028,6 +1107,11 @@ declare module 'stripe' {
            */
           metadata: Stripe.Metadata | null;
 
+          /**
+           * If specified, payment collection for this subscription will be paused. Note that the subscription status will be unchanged and will not be updated to `paused`. Learn more about [pausing collection](https://stripe.com/docs/billing/subscriptions/pause-payment).
+           */
+          pause_collection?: SubscriptionDetails.PauseCollection | null;
+
           /**
            * The subscription that generated this invoice
            */
@@ -1039,6 +1123,24 @@ declare module 'stripe' {
           subscription_proration_date?: number;
         }
 
+        namespace SubscriptionDetails {
+          interface PauseCollection {
+            /**
+             * The payment collection behavior for this subscription while paused. One of `keep_as_draft`, `mark_uncollectible`, or `void`.
+             */
+            behavior: PauseCollection.Behavior | null;
+
+            /**
+             * The time after which the subscription will resume collecting payments.
+             */
+            resumes_at: number | null;
+          }
+
+          namespace PauseCollection {
+            type Behavior = 'keep_as_draft' | 'mark_uncollectible' | 'void';
+          }
+        }
+
         type Type = 'quote_details' | 'subscription_details';
       }
 
@@ -1081,6 +1183,11 @@ declare module 'stripe' {
            */
           customer_balance: PaymentMethodOptions.CustomerBalance | null;
 
+          /**
+           * If paying by `id_bank_transfer`, this sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice's PaymentIntent.
+           */
+          id_bank_transfer?: PaymentMethodOptions.IdBankTransfer | null;
+
           /**
            * If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1186,6 +1293,8 @@ declare module 'stripe' {
             }
           }
 
+          interface IdBankTransfer {}
+
           interface Konbini {}
 
           interface SepaDebit {}
@@ -1220,6 +1329,11 @@ 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 {
@@ -1232,7 +1346,11 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
@@ -1250,11 +1368,13 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
+          | 'custom'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
           | 'giropay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -1274,6 +1394,7 @@ declare module 'stripe' {
           | 'sepa_credit_transfer'
           | 'sepa_debit'
           | 'sofort'
+          | 'stripe_balance'
           | 'swish'
           | 'us_bank_account'
           | 'wechat_pay';
@@ -1472,6 +1593,18 @@ declare module 'stripe' {
         discount: string | Stripe.Discount | Stripe.DeletedDiscount;
       }
 
+      interface TotalMarginAmount {
+        /**
+         * The amount, in cents (or local equivalent), of the reduction in line item amount.
+         */
+        amount: number;
+
+        /**
+         * The margin that was applied to get this margin amount.
+         */
+        margin: string | Stripe.Margin;
+      }
+
       interface TotalPretaxCreditAmount {
         /**
          * The amount, in cents (or local equivalent), of the pretax credit amount.
@@ -1491,6 +1624,11 @@ declare module 'stripe' {
          */
         discount?: string | Stripe.Discount | Stripe.DeletedDiscount;
 
+        /**
+         * The margin that was applied to get this pretax credit amount.
+         */
+        margin?: string | Stripe.Margin;
+
         /**
          * Type of the pretax credit amount referenced.
          */
@@ -1498,7 +1636,7 @@ declare module 'stripe' {
       }
 
       namespace TotalPretaxCreditAmount {
-        type Type = 'credit_balance_transaction' | 'discount';
+        type Type = 'credit_balance_transaction' | 'discount' | 'margin';
       }
 
       interface TotalTax {