stripe 20.0.0 → 20.1.0-alpha.1

package/types/Issuing/DisputeSettlementDetails.d.ts

@@ -0,0 +1,85 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      /**
+       * Represents a record from the card network of a money movement or change in state for an Issuing dispute. These records are included in the settlement reports that we receive from networks and expose to users as Settlement objects.
+       */
+      interface DisputeSettlementDetail {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'issuing.dispute_settlement_detail';
+
+        /**
+         * Disputed amount in the card's currency and in the smallest currency unit. Usually the amount of the transaction, but can differ (usually because of currency fluctuation).
+         */
+        amount: number;
+
+        /**
+         * The card used to make the original transaction.
+         */
+        card: string;
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * The currency the original transaction was made in. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * The ID of the linked dispute.
+         */
+        dispute: string;
+
+        /**
+         * The type of event corresponding to this dispute settlement detail, representing the stage in the dispute network lifecycle.
+         */
+        event_type: DisputeSettlementDetail.EventType;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * The card network for this dispute settlement detail. One of ["visa", "mastercard", "maestro"]
+         */
+        network: DisputeSettlementDetail.Network;
+
+        /**
+         * Details about the transaction, such as processing dates, set by the card network.
+         */
+        network_data: DisputeSettlementDetail.NetworkData | null;
+
+        /**
+         * The ID of the linked card network settlement.
+         */
+        settlement: string | null;
+      }
+
+      namespace DisputeSettlementDetail {
+        type EventType = 'filing' | 'loss' | 'representment' | 'win';
+
+        type Network = 'maestro' | 'mastercard' | 'visa';
+
+        interface NetworkData {
+          /**
+           * The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
+           */
+          processing_date: string | null;
+        }
+      }
+    }
+  }
+}

package/types/Issuing/DisputeSettlementDetailsResource.d.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      interface DisputeSettlementDetailRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface DisputeSettlementDetailListParams extends PaginationParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * Select the Issuing dispute settlement details for the given settlement.
+         */
+        settlement?: string;
+      }
+
+      class DisputeSettlementDetailsResource {
+        /**
+         * Retrieves an Issuing DisputeSettlementDetail object.
+         */
+        retrieve(
+          id: string,
+          params?: DisputeSettlementDetailRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.DisputeSettlementDetail>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.DisputeSettlementDetail>>;
+
+        /**
+         * Returns a list of Issuing DisputeSettlementDetail objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+         */
+        list(
+          params?: DisputeSettlementDetailListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Issuing.DisputeSettlementDetail>;
+        list(
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Issuing.DisputeSettlementDetail>;
+      }
+    }
+  }
+}

package/types/Issuing/FraudLiabilityDebits.d.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      /**
+       * A fraud liability debit occurs when Stripe debits a platform's account for fraud losses on Issuing transactions.
+       */
+      interface FraudLiabilityDebit {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'issuing.fraud_liability_debit';
+
+        /**
+         * Debited amount. This is equal to the disputed amount and is given in the card's currency and in the smallest currency unit.
+         */
+        amount: number;
+
+        /**
+         * ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this debit.
+         */
+        balance_transaction: string | Stripe.BalanceTransaction | null;
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * The currency of the debit. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * The ID of the linked dispute.
+         */
+        dispute: string;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+      }
+    }
+  }
+}

package/types/Issuing/FraudLiabilityDebitsResource.d.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      interface FraudLiabilityDebitRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface FraudLiabilityDebitListParams extends PaginationParams {
+        /**
+         * Only return Issuing Fraud Liability Debits that were created during the given date interval.
+         */
+        created?: Stripe.RangeQueryParam | number;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class FraudLiabilityDebitsResource {
+        /**
+         * Retrieves an Issuing FraudLiabilityDebit object.
+         */
+        retrieve(
+          id: string,
+          params?: FraudLiabilityDebitRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.FraudLiabilityDebit>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.FraudLiabilityDebit>>;
+
+        /**
+         * Returns a list of Issuing FraudLiabilityDebit objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+         */
+        list(
+          params?: FraudLiabilityDebitListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Issuing.FraudLiabilityDebit>;
+        list(
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Issuing.FraudLiabilityDebit>;
+      }
+    }
+  }
+}

package/types/Issuing/Programs.d.ts

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      /**
+       * An Issuing `Program` represents a card program that the user has access to.
+       */
+      interface Program {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'issuing.program';
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * Whether or not this is the "default" issuing program new cards are created on. Only one active `is_default` program at the same time.
+         */
+        is_default: boolean;
+
+        /**
+         * 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.
+         */
+        metadata: Stripe.Metadata;
+
+        /**
+         * The platform's Issuing Program for which this program is associated.
+         */
+        platform_program: string | null;
+      }
+    }
+  }
+}

package/types/Issuing/ProgramsResource.d.ts

@@ -0,0 +1,96 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      interface ProgramCreateParams {
+        /**
+         * The program to use as the parent for the new program to create.
+         */
+        platform_program: string;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * If true, makes the specified program the default for the given account.
+         */
+        is_default?: boolean;
+      }
+
+      interface ProgramRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface ProgramUpdateParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * If true, makes the specified program the default.
+         */
+        is_default?: boolean;
+
+        /**
+         * 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`.
+         */
+        metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
+      }
+
+      interface ProgramListParams extends PaginationParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class ProgramsResource {
+        /**
+         * Create a Program object.
+         */
+        create(
+          params: ProgramCreateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.Program>>;
+
+        /**
+         * Retrieves the program specified by the given id.
+         */
+        retrieve(
+          id: string,
+          params?: ProgramRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.Program>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.Program>>;
+
+        /**
+         * Updates a Program object.
+         */
+        update(
+          id: string,
+          params?: ProgramUpdateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Issuing.Program>>;
+
+        /**
+         * List all of the programs the given Issuing user has access to.
+         */
+        list(
+          params?: ProgramListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Issuing.Program>;
+        list(options?: RequestOptions): ApiListPromise<Stripe.Issuing.Program>;
+      }
+    }
+  }
+}

package/types/Issuing/Settlements.d.ts

@@ -0,0 +1,113 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Issuing {
+      /**
+       * When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object.
+       */
+      interface Settlement {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'issuing.settlement';
+
+        /**
+         * The Bank Identification Number reflecting this settlement record.
+         */
+        bin: string;
+
+        /**
+         * The date that the transactions are cleared and posted to user's accounts.
+         */
+        clearing_date: number;
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * The total interchange received as reimbursement for the transactions.
+         */
+        interchange_fees_amount: number;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * 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.
+         */
+        metadata: Stripe.Metadata;
+
+        /**
+         * The total net amount required to settle with the network.
+         */
+        net_total_amount: number;
+
+        /**
+         * The card network for this settlement report. One of ["visa", "maestro"]
+         */
+        network: Settlement.Network;
+
+        /**
+         * The total amount of fees owed to the network.
+         */
+        network_fees_amount: number;
+
+        /**
+         * The Settlement Identification Number assigned by the network.
+         */
+        network_settlement_identifier: string;
+
+        /**
+         * The total amount of any additional fees assessed by the card network.
+         */
+        other_fees_amount?: number;
+
+        /**
+         * The total number of additional fees assessed by the card network.
+         */
+        other_fees_count?: number;
+
+        /**
+         * One of `international` or `uk_national_net`.
+         */
+        settlement_service: string;
+
+        /**
+         * The current processing status of this settlement.
+         */
+        status: Settlement.Status;
+
+        /**
+         * The total transaction amount reflected in this settlement.
+         */
+        transaction_amount: number;
+
+        /**
+         * The total number of transactions reflected in this settlement.
+         */
+        transaction_count: number;
+      }
+
+      namespace Settlement {
+        type Network = 'maestro' | 'visa';
+
+        type Status = 'complete' | 'pending';
+      }
+    }
+  }
+}

package/types/Issuing/Transactions.d.ts

@@ -98,6 +98,11 @@ declare module 'stripe' {
          */
         purchase_details?: Transaction.PurchaseDetails | null;
 
+        /**
+         * The ID of the [settlement](https://stripe.com/docs/api/issuing/settlements) to which this transaction belongs.
+         */
+        settlement?: string | Stripe.Issuing.Settlement | null;
+
         /**
          * [Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
          */

package/types/Issuing/TransactionsResource.d.ts

@@ -43,6 +43,11 @@ declare module 'stripe' {
          */
         expand?: Array<string>;
 
+        /**
+         * Only return transactions that are associated with the given settlement.
+         */
+        settlement?: string;
+
         /**
          * Only return transactions that have the given type. One of `capture` or `refund`.
          */

package/types/LineItems.d.ts

@@ -16,6 +16,8 @@ declare module 'stripe' {
        */
       object: 'item';
 
+      adjustable_quantity?: LineItem.AdjustableQuantity | null;
+
       /**
        * Total discount amount applied. If no discounts were applied, defaults to 0.
        */
@@ -51,16 +53,35 @@ declare module 'stripe' {
        */
       discounts?: Array<LineItem.Discount>;
 
+      display?: LineItem.Display;
+
+      /**
+       * 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.
+       */
+      metadata?: Stripe.Metadata | null;
+
       /**
        * The price used to generate the line item.
        */
       price: Stripe.Price | null;
 
+      /**
+       * The ID of the product for this line item.
+       *
+       * This will always be the same as `price.product`.
+       */
+      product?: string | Stripe.Product | Stripe.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.
        */
@@ -68,6 +89,14 @@ declare module 'stripe' {
     }
 
     namespace LineItem {
+      interface AdjustableQuantity {
+        enabled: boolean;
+
+        maximum: number | null;
+
+        minimum: number | null;
+      }
+
       interface Discount {
         /**
          * The amount discounted.
@@ -83,6 +112,14 @@ declare module 'stripe' {
         discount: Stripe.Discount;
       }
 
+      interface Display {
+        description: string | null;
+
+        images: Array<string>;
+
+        name: string;
+      }
+
       interface Tax {
         /**
          * Amount of tax applied for this rate.
@@ -125,6 +162,18 @@ declare module 'stripe' {
           | 'taxable_basis_reduced'
           | 'zero_rated';
       }
+
+      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;
+      }
     }
   }
 }