stripe 18.1.0-beta.3 → 18.1.1

package/types/InvoiceItemsResource.d.ts

@@ -3,6 +3,11 @@
 declare module 'stripe' {
   namespace Stripe {
     interface InvoiceItemCreateParams {
+      /**
+       * The ID of the customer who will be billed when this invoice item is billed.
+       */
+      customer: string;
+
       /**
        * The integer amount in cents (or local equivalent) of the charge to be applied to the upcoming invoice. Passing in a negative `amount` will reduce the `amount_due` on the invoice.
        */
@@ -13,16 +18,6 @@ declare module 'stripe' {
        */
       currency?: string;
 
-      /**
-       * The ID of the customer who will be billed when this invoice item is billed.
-       */
-      customer?: string;
-
-      /**
-       * The ID of the account who will be billed when this invoice item is billed.
-       */
-      customer_account?: string;
-
       /**
        * An arbitrary string which you can attach to the invoice item. The description is displayed in the invoice for easy tracking.
        */
@@ -48,11 +43,6 @@ declare module 'stripe' {
        */
       invoice?: string;
 
-      /**
-       * The ids of the margins to apply to the invoice item. When set, the `default_margins` on the invoice do not apply to this invoice item.
-       */
-      margins?: Array<string>;
-
       /**
        * 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`.
        */
@@ -116,56 +106,12 @@ declare module 'stripe' {
          */
         discount?: string;
 
-        /**
-         * Details to determine how long the discount should be applied for.
-         */
-        discount_end?: Discount.DiscountEnd;
-
         /**
          * ID of the promotion code to create a new discount for.
          */
         promotion_code?: string;
       }
 
-      namespace Discount {
-        interface DiscountEnd {
-          /**
-           * Time span for the redeemed discount.
-           */
-          duration?: DiscountEnd.Duration;
-
-          /**
-           * A precise Unix timestamp for the discount to end. Must be in the future.
-           */
-          timestamp?: number;
-
-          /**
-           * The type of calculation made to determine when the discount ends.
-           */
-          type: DiscountEnd.Type;
-        }
-
-        namespace DiscountEnd {
-          interface Duration {
-            /**
-             * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-             */
-            interval: Duration.Interval;
-
-            /**
-             * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-             */
-            interval_count: number;
-          }
-
-          namespace Duration {
-            type Interval = 'day' | 'month' | 'week' | 'year';
-          }
-
-          type Type = 'duration' | 'timestamp';
-        }
-      }
-
       interface Period {
         /**
          * The end of the period, which must be greater than or equal to the start. This value is inclusive.
@@ -252,11 +198,6 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
-      /**
-       * The ids of the margins to apply to the invoice item. When set, the `default_margins` on the invoice do not apply to this invoice item.
-       */
-      margins?: Stripe.Emptyable<Array<string>>;
-
       /**
        * 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`.
        */
@@ -315,56 +256,12 @@ declare module 'stripe' {
          */
         discount?: string;
 
-        /**
-         * Details to determine how long the discount should be applied for.
-         */
-        discount_end?: Discount.DiscountEnd;
-
         /**
          * ID of the promotion code to create a new discount for.
          */
         promotion_code?: string;
       }
 
-      namespace Discount {
-        interface DiscountEnd {
-          /**
-           * Time span for the redeemed discount.
-           */
-          duration?: DiscountEnd.Duration;
-
-          /**
-           * A precise Unix timestamp for the discount to end. Must be in the future.
-           */
-          timestamp?: number;
-
-          /**
-           * The type of calculation made to determine when the discount ends.
-           */
-          type: DiscountEnd.Type;
-        }
-
-        namespace DiscountEnd {
-          interface Duration {
-            /**
-             * Specifies a type of interval unit. Either `day`, `week`, `month` or `year`.
-             */
-            interval: Duration.Interval;
-
-            /**
-             * The number of intervals, as an whole number greater than 0. Stripe multiplies this by the interval type to get the overall duration.
-             */
-            interval_count: number;
-          }
-
-          namespace Duration {
-            type Interval = 'day' | 'month' | 'week' | 'year';
-          }
-
-          type Type = 'duration' | 'timestamp';
-        }
-      }
-
       interface Period {
         /**
          * The end of the period, which must be greater than or equal to the start. This value is inclusive.
@@ -429,11 +326,6 @@ declare module 'stripe' {
        */
       customer?: string;
 
-      /**
-       * The identifier of the account whose invoice items to return. If none is provided, all invoice items will be returned.
-       */
-      customer_account?: string;
-
       /**
        * Specifies which fields in the response should be expanded.
        */
@@ -457,10 +349,7 @@ declare module 'stripe' {
        * Creates an item to be added to a draft invoice (up to 250 items per invoice). If no invoice is specified, the item will be on the next invoice created for the customer specified.
        */
       create(
-        params?: InvoiceItemCreateParams,
-        options?: RequestOptions
-      ): Promise<Stripe.Response<Stripe.InvoiceItem>>;
-      create(
+        params: InvoiceItemCreateParams,
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.InvoiceItem>>;
 

package/types/InvoiceLineItems.d.ts

@@ -58,16 +58,6 @@ declare module 'stripe' {
        */
       livemode: boolean;
 
-      /**
-       * The amount of margin calculated per margin for this line item.
-       */
-      margin_amounts?: Array<InvoiceLineItem.MarginAmount> | null;
-
-      /**
-       * The margins applied to the line item. When set, the `default_margins` on the invoice do not apply to the line item. Use `expand[]=margins` to expand each margin.
-       */
-      margins?: Array<string | Stripe.Margin> | null;
-
       /**
        * 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. Note that for line items with `type=subscription`, `metadata` reflects the current metadata from the subscription associated with the line item, unless the invoice line was directly updated with different metadata after creation.
        */
@@ -97,11 +87,6 @@ declare module 'stripe' {
 
       subscription: string | Stripe.Subscription | null;
 
-      /**
-       * The tax calculation identifiers of the line item.
-       */
-      tax_calculation_reference?: InvoiceLineItem.TaxCalculationReference | null;
-
       /**
        * The tax information of the line item.
        */
@@ -121,18 +106,6 @@ declare module 'stripe' {
         discount: string | Stripe.Discount | Stripe.DeletedDiscount;
       }
 
-      interface MarginAmount {
-        /**
-         * 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 Parent {
         /**
          * Details about the invoice item that generated this line item
@@ -215,7 +188,7 @@ declare module 'stripe' {
           /**
            * The subscription that the subscription item belongs to
            */
-          subscription: string;
+          subscription: string | null;
 
           /**
            * The subscription item that generated this line item
@@ -280,11 +253,6 @@ 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.
          */
@@ -292,7 +260,7 @@ declare module 'stripe' {
       }
 
       namespace PretaxCreditAmount {
-        type Type = 'credit_balance_transaction' | 'discount' | 'margin';
+        type Type = 'credit_balance_transaction' | 'discount';
       }
 
       interface Pricing {
@@ -380,18 +348,6 @@ declare module 'stripe' {
           tax_rate: string;
         }
       }
-
-      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;
-      }
     }
   }
 }

package/types/InvoicePayments.d.ts

@@ -73,11 +73,6 @@ declare module 'stripe' {
          */
         payment_intent?: string | Stripe.PaymentIntent;
 
-        /**
-         * ID of the PaymentRecord associated with this payment when `type` is `payment_record`.
-         */
-        payment_record?: string | Stripe.PaymentRecord;
-
         /**
          * Type of payment object associated with this invoice payment.
          */

package/types/InvoicePaymentsResource.d.ts

@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    interface InvoicePaymentRetrieveParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
+    interface InvoicePaymentListParams extends PaginationParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      /**
+       * The identifier of the invoice whose payments to return.
+       */
+      invoice?: string;
+
+      /**
+       * The payment details of the invoice payments to return.
+       */
+      payment?: InvoicePaymentListParams.Payment;
+
+      /**
+       * The status of the invoice payments to return.
+       */
+      status?: InvoicePaymentListParams.Status;
+    }
+
+    namespace InvoicePaymentListParams {
+      interface Payment {
+        /**
+         * Only return invoice payments associated by this payment intent ID.
+         */
+        payment_intent?: string;
+
+        /**
+         * Only return invoice payments associated by this payment type.
+         */
+        type: 'payment_intent';
+      }
+
+      type Status = 'canceled' | 'open' | 'paid';
+    }
+
+    class InvoicePaymentsResource {
+      /**
+       * Retrieves the invoice payment with the given ID.
+       */
+      retrieve(
+        id: string,
+        params?: InvoicePaymentRetrieveParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.InvoicePayment>>;
+      retrieve(
+        id: string,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.InvoicePayment>>;
+
+      /**
+       * When retrieving an invoice, there is an includable payments property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of payments.
+       */
+      list(
+        params?: InvoicePaymentListParams,
+        options?: RequestOptions
+      ): ApiListPromise<Stripe.InvoicePayment>;
+      list(options?: RequestOptions): ApiListPromise<Stripe.InvoicePayment>;
+    }
+  }
+}