stripe 22.3.0 → 22.4.0-beta.1

package/esm/resources/LineItems.d.ts

@@ -1,5 +1,6 @@
 import { Discount as _Discount } from './Discounts.js';
 import { Price } from './Prices.js';
+import { Product, DeletedProduct } from './Products.js';
 import { TaxRate } from './TaxRates.js';
 import { Metadata } from '../shared.js';
 export interface LineItem {
@@ -11,7 +12,7 @@ export interface LineItem {
      * String representing the object's type. Objects of the same type share the same value.
      */
     object: 'item';
-    adjustable_quantity: LineItem.AdjustableQuantity | null;
+    adjustable_quantity?: LineItem.AdjustableQuantity | null;
     /**
      * Total discount amount applied. If no discounts were applied, defaults to 0.
      */
@@ -40,18 +41,29 @@ export interface LineItem {
      * The discounts applied to the line item.
      */
     discounts?: Array<LineItem.Discount>;
+    display?: LineItem.Display;
     /**
      * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
      */
-    metadata: Metadata | null;
+    metadata?: Metadata | null;
     /**
      * The price used to generate the line item.
      */
     price: Price | null;
+    /**
+     * The ID of the product for this line item.
+     *
+     * This will always be the same as `price.product`.
+     */
+    product?: string | Product | DeletedProduct;
     /**
      * The quantity of products being purchased.
      */
     quantity: number | null;
+    /**
+     * The tax calculation identifiers of the line item.
+     */
+    tax_calculation_reference?: LineItem.TaxCalculationReference | null;
     /**
      * The taxes applied to the line item.
      */
@@ -76,6 +88,21 @@ export declare namespace LineItem {
          */
         discount: _Discount;
     }
+    interface Display {
+        description: string | null;
+        images: Array<string>;
+        name: 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;
+    }
     interface Tax {
         /**
          * Amount of tax applied for this rate.

package/esm/resources/Mandates.d.ts

@@ -1,7 +1,12 @@
 import { StripeResource } from '../StripeResource.js';
 import { PaymentMethod } from './PaymentMethods.js';
-import { RequestOptions, Response } from '../lib.js';
+import { PaginationParams } from '../shared.js';
+import { RequestOptions, ApiListPromise, Response } from '../lib.js';
 export declare class MandateResource extends StripeResource {
+    /**
+     * Retrieves a list of Mandates for a given PaymentMethod.
+     */
+    list(params: MandateListParams, options?: RequestOptions): ApiListPromise<Mandate>;
     /**
      * Retrieves a Mandate object.
      */
@@ -191,10 +196,19 @@ export declare namespace Mandate {
              * The PayPal Billing Agreement ID (BAID). This is an ID generated by PayPal which represents the mandate between the merchant and the customer.
              */
             billing_agreement_id: 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;
             /**
              * 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 {
             /**
@@ -320,3 +334,21 @@ export interface MandateRetrieveParams {
      */
     expand?: Array<string>;
 }
+export interface MandateListParams extends PaginationParams {
+    payment_method: string;
+    /**
+     * The status of the mandates to retrieve. Status indicates whether or not you can use it to initiate a payment, and can have a value of `active`, `pending`, or `inactive`.
+     */
+    status: MandateListParams.Status;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * The Stripe account ID that the mandates are intended for. Learn more about the [use case for connected accounts payments](https://docs.stripe.com/payments/connected-accounts).
+     */
+    on_behalf_of?: string;
+}
+export declare namespace MandateListParams {
+    type Status = 'active' | 'inactive' | 'pending';
+}

package/esm/resources/Mandates.js

@@ -1,6 +1,14 @@
 // File generated from our OpenAPI spec
 import { StripeResource } from '../StripeResource.js';
 export class MandateResource extends StripeResource {
+    /**
+     * Retrieves a list of Mandates for a given PaymentMethod.
+     */
+    list(params, options) {
+        return this._makeRequest('GET', '/v1/mandates', params, options, {
+            methodType: 'list',
+        });
+    }
     /**
      * Retrieves a Mandate object.
      */

package/esm/resources/Mandates.js.map

@@ -1 +1 @@
-{"version":3,"file":"Mandates.js","sourceRoot":"","sources":["../../src/resources/Mandates.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAIpD,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACxC,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF"}
+{"version":3,"file":"Mandates.js","sourceRoot":"","sources":["../../src/resources/Mandates.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAKpD,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD;;OAEG;IACH,IAAI,CACF,MAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE;YAC/D,UAAU,EAAE,MAAM;SACnB,CAAQ,CAAC;IACZ,CAAC;IACD;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACxC,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF"}

package/esm/resources/Margins.d.ts

@@ -0,0 +1,115 @@
+import { StripeResource } from '../StripeResource.js';
+import { MetadataParam, PaginationParams, Metadata } from '../shared.js';
+import { RequestOptions, ApiListPromise, Response } from '../lib.js';
+export declare class MarginResource extends StripeResource {
+    /**
+     * Retrieve a list of your margins.
+     */
+    list(params?: MarginListParams, options?: RequestOptions): ApiListPromise<Margin>;
+    /**
+     * Create a margin object to be used with invoices, invoice items, and invoice line items for a customer to represent a partner discount. A margin has a percent_off which is the percent that will be taken off the subtotal after all items and other discounts and promotions) of any invoices for a customer. Calculation of prorations do not include any partner margins applied on the original invoice item.
+     */
+    create(params: MarginCreateParams, options?: RequestOptions): Promise<Response<Margin>>;
+    /**
+     * Retrieve a margin object with the given ID.
+     */
+    retrieve(id: string, params?: MarginRetrieveParams, options?: RequestOptions): Promise<Response<Margin>>;
+    /**
+     * Update the specified margin object. Certain fields of the margin object are not editable.
+     */
+    update(id: string, params?: MarginUpdateParams, options?: RequestOptions): Promise<Response<Margin>>;
+}
+export interface Margin {
+    /**
+     * Unique identifier for the object.
+     */
+    id: string;
+    /**
+     * String representing the object's type. Objects of the same type share the same value.
+     */
+    object: 'margin';
+    /**
+     * Whether the margin can be applied to invoices, invoice items, or invoice line items. Defaults to `true`.
+     */
+    active: boolean;
+    /**
+     * Time at which the object was created. Measured in seconds since the Unix epoch.
+     */
+    created: number;
+    /**
+     * If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
+     */
+    livemode: boolean;
+    /**
+     * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+     */
+    metadata: Metadata | null;
+    /**
+     * Name of the margin that's displayed on, for example, invoices.
+     */
+    name: string | null;
+    /**
+     * Percent that will be taken off the subtotal before tax (after all other discounts and promotions) of any invoice to which the margin is applied.
+     */
+    percent_off: number;
+    /**
+     * Time at which the object was last updated. Measured in seconds since the Unix epoch.
+     */
+    updated: number;
+}
+export interface MarginCreateParams {
+    /**
+     * Percent that will be taken off the subtotal before tax (after all other discounts and promotions) of any invoice to which the margin is applied.
+     */
+    percent_off: number;
+    /**
+     * Whether the margin can be applied to invoices, invoice items, or invoice line items or not. Defaults to `true`.
+     */
+    active?: boolean;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * Set of [key-value pairs](https://docs.stripe.com/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`.
+     */
+    metadata?: MetadataParam;
+    /**
+     * Name of the margin, which is displayed to customers, such as on invoices.
+     */
+    name?: string;
+}
+export interface MarginRetrieveParams {
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+}
+export interface MarginUpdateParams {
+    /**
+     * Whether the margin can be applied to invoices, invoice items, or invoice line items or not.
+     */
+    active?: boolean;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+    /**
+     * Set of [key-value pairs](https://docs.stripe.com/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`.
+     */
+    metadata?: MetadataParam;
+    /**
+     * Name of the margin, which is displayed to customers, such as on invoices.
+     */
+    name?: string;
+}
+export interface MarginListParams extends PaginationParams {
+    /**
+     * Only return margins that are active or inactive. For example, pass `true` to only list active margins.
+     */
+    active?: boolean;
+    /**
+     * Specifies which fields in the response should be expanded.
+     */
+    expand?: Array<string>;
+}

package/esm/resources/Margins.js

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../StripeResource.js';
+export class MarginResource extends StripeResource {
+    /**
+     * Retrieve a list of your margins.
+     */
+    list(params, options) {
+        return this._makeRequest('GET', '/v1/billing/margins', params, options, {
+            methodType: 'list',
+        });
+    }
+    /**
+     * Create a margin object to be used with invoices, invoice items, and invoice line items for a customer to represent a partner discount. A margin has a percent_off which is the percent that will be taken off the subtotal after all items and other discounts and promotions) of any invoices for a customer. Calculation of prorations do not include any partner margins applied on the original invoice item.
+     */
+    create(params, options) {
+        return this._makeRequest('POST', '/v1/billing/margins', params, options);
+    }
+    /**
+     * Retrieve a margin object with the given ID.
+     */
+    retrieve(id, params, options) {
+        return this._makeRequest('GET', `/v1/billing/margins/${encodeURIComponent(id)}`, params, options);
+    }
+    /**
+     * Update the specified margin object. Certain fields of the margin object are not editable.
+     */
+    update(id, params, options) {
+        return this._makeRequest('POST', `/v1/billing/margins/${encodeURIComponent(id)}`, params, options);
+    }
+}
+//# sourceMappingURL=Margins.js.map

package/esm/resources/Margins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Margins.js","sourceRoot":"","sources":["../../src/resources/Margins.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAEvC,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAIpD,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD;;OAEG;IACH,IAAI,CACF,MAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,OAAO,EAAE;YACtE,UAAU,EAAE,MAAM;SACnB,CAAQ,CAAC;IACZ,CAAC;IACD;;OAEG;IACH,MAAM,CACJ,MAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,qBAAqB,EACrB,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAC/C,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,MAAM,CACJ,EAAU,EACV,MAA2B,EAC3B,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAC/C,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF"}