stripe 19.2.1 → 19.3.0-alpha.2

package/types/DelegatedCheckout/RequestedSessionsResource.d.ts

@@ -0,0 +1,593 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace DelegatedCheckout {
+      interface RequestedSessionCreateParams {
+        /**
+         * The currency for this requested session.
+         */
+        currency: string;
+
+        /**
+         * The details of the line items.
+         */
+        line_item_details: Array<RequestedSessionCreateParams.LineItemDetail>;
+
+        /**
+         * The details of the seller.
+         */
+        seller_details: RequestedSessionCreateParams.SellerDetails;
+
+        /**
+         * The customer for this requested session.
+         */
+        customer?: string;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * The details of the fulfillment.
+         */
+        fulfillment_details?: RequestedSessionCreateParams.FulfillmentDetails;
+
+        /**
+         * The metadata for this requested session.
+         */
+        metadata?: Stripe.MetadataParam;
+
+        /**
+         * The payment method for this requested session.
+         */
+        payment_method?: string;
+
+        /**
+         * The payment method data for this requested session.
+         */
+        payment_method_data?: RequestedSessionCreateParams.PaymentMethodData;
+
+        /**
+         * The setup future usage for this requested session.
+         */
+        setup_future_usage?: 'on_session';
+
+        /**
+         * The shared metadata for this requested session.
+         */
+        shared_metadata?: {
+          [key: string]: string;
+        };
+      }
+
+      namespace RequestedSessionCreateParams {
+        interface FulfillmentDetails {
+          address?: FulfillmentDetails.Address;
+
+          /**
+           * The customer's email address.
+           */
+          email?: string;
+
+          /**
+           * The customer's name.
+           */
+          name?: string;
+
+          /**
+           * The customer's phone number.
+           */
+          phone?: string;
+        }
+
+        namespace FulfillmentDetails {
+          interface Address {
+            /**
+             * City, district, suburb, town, or village.
+             */
+            city: string;
+
+            /**
+             * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+             */
+            country: string;
+
+            /**
+             * Address line 1, such as the street, PO Box, or company name.
+             */
+            line1: string;
+
+            /**
+             * Address line 2, such as the apartment, suite, unit, or building.
+             */
+            line2?: string;
+
+            /**
+             * ZIP or postal code.
+             */
+            postal_code: string;
+
+            /**
+             * State, county, province, or region.
+             */
+            state: string;
+          }
+        }
+
+        interface LineItemDetail {
+          /**
+           * The quantity of the line item.
+           */
+          quantity: number;
+
+          /**
+           * The SKU ID of the line item.
+           */
+          sku_id: string;
+        }
+
+        interface PaymentMethodData {
+          /**
+           * The billing details for the payment method data.
+           */
+          billing_details?: PaymentMethodData.BillingDetails;
+
+          /**
+           * The card for the payment method data.
+           */
+          card?: PaymentMethodData.Card;
+
+          /**
+           * The type of the payment method data.
+           */
+          type?: 'card';
+        }
+
+        namespace PaymentMethodData {
+          interface BillingDetails {
+            /**
+             * The address for the billing details.
+             */
+            address?: BillingDetails.Address;
+
+            /**
+             * The email for the billing details.
+             */
+            email?: string;
+
+            /**
+             * The name for the billing details.
+             */
+            name?: string;
+
+            /**
+             * The phone for the billing details.
+             */
+            phone?: string;
+          }
+
+          namespace BillingDetails {
+            interface Address {
+              /**
+               * City, district, suburb, town, or village.
+               */
+              city: string;
+
+              /**
+               * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+               */
+              country: string;
+
+              /**
+               * Address line 1, such as the street, PO Box, or company name.
+               */
+              line1: string;
+
+              /**
+               * Address line 2, such as the apartment, suite, unit, or building.
+               */
+              line2?: string;
+
+              /**
+               * ZIP or postal code.
+               */
+              postal_code: string;
+
+              /**
+               * State, county, province, or region.
+               */
+              state: string;
+            }
+          }
+
+          interface Card {
+            /**
+             * The CVC of the card.
+             */
+            cvc?: string;
+
+            /**
+             * The expiration month of the card.
+             */
+            exp_month: number;
+
+            /**
+             * The expiration year of the card.
+             */
+            exp_year: number;
+
+            /**
+             * The number of the card.
+             */
+            number: string;
+          }
+        }
+
+        interface SellerDetails {
+          /**
+           * The network profile for the seller.
+           */
+          network_profile: string;
+        }
+      }
+
+      interface RequestedSessionRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface RequestedSessionUpdateParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * The details of the fulfillment.
+         */
+        fulfillment_details?: RequestedSessionUpdateParams.FulfillmentDetails;
+
+        /**
+         * The details of the line items.
+         */
+        line_item_details?: Array<RequestedSessionUpdateParams.LineItemDetail>;
+
+        /**
+         * The metadata for this requested session.
+         */
+        metadata?: Stripe.MetadataParam;
+
+        /**
+         * The payment method for this requested session.
+         */
+        payment_method?: string;
+
+        /**
+         * The payment method data for this requested session.
+         */
+        payment_method_data?: RequestedSessionUpdateParams.PaymentMethodData;
+
+        /**
+         * The shared metadata for this requested session.
+         */
+        shared_metadata?: {
+          [key: string]: string;
+        };
+      }
+
+      namespace RequestedSessionUpdateParams {
+        interface FulfillmentDetails {
+          address?: FulfillmentDetails.Address;
+
+          /**
+           * The customer's email address.
+           */
+          email?: string;
+
+          /**
+           * The customer's name.
+           */
+          name?: string;
+
+          /**
+           * The customer's phone number.
+           */
+          phone?: string;
+
+          /**
+           * The fulfillment option to select.
+           */
+          selected_fulfillment_option?: FulfillmentDetails.SelectedFulfillmentOption;
+        }
+
+        namespace FulfillmentDetails {
+          interface Address {
+            /**
+             * City, district, suburb, town, or village.
+             */
+            city: string;
+
+            /**
+             * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+             */
+            country: string;
+
+            /**
+             * Address line 1, such as the street, PO Box, or company name.
+             */
+            line1: string;
+
+            /**
+             * Address line 2, such as the apartment, suite, unit, or building.
+             */
+            line2?: string;
+
+            /**
+             * ZIP or postal code.
+             */
+            postal_code: string;
+
+            /**
+             * State, county, province, or region.
+             */
+            state: string;
+          }
+
+          interface SelectedFulfillmentOption {
+            /**
+             * The shipping fulfillment option.
+             */
+            shipping: SelectedFulfillmentOption.Shipping;
+
+            /**
+             * The type of fulfillment option.
+             */
+            type: string;
+          }
+
+          namespace SelectedFulfillmentOption {
+            interface Shipping {
+              /**
+               * The shipping option identifer.
+               */
+              shipping_option: string;
+            }
+          }
+        }
+
+        interface LineItemDetail {
+          /**
+           * The key of the line item.
+           */
+          key: string;
+
+          /**
+           * The quantity of the line item.
+           */
+          quantity: number;
+        }
+
+        interface PaymentMethodData {
+          /**
+           * The billing details for the payment method data.
+           */
+          billing_details?: PaymentMethodData.BillingDetails;
+
+          /**
+           * The card for the payment method data.
+           */
+          card?: PaymentMethodData.Card;
+
+          /**
+           * The type of the payment method data.
+           */
+          type?: 'card';
+        }
+
+        namespace PaymentMethodData {
+          interface BillingDetails {
+            /**
+             * The address for the billing details.
+             */
+            address?: BillingDetails.Address;
+
+            /**
+             * The email for the billing details.
+             */
+            email?: string;
+
+            /**
+             * The name for the billing details.
+             */
+            name?: string;
+
+            /**
+             * The phone for the billing details.
+             */
+            phone?: string;
+          }
+
+          namespace BillingDetails {
+            interface Address {
+              /**
+               * City, district, suburb, town, or village.
+               */
+              city: string;
+
+              /**
+               * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+               */
+              country: string;
+
+              /**
+               * Address line 1, such as the street, PO Box, or company name.
+               */
+              line1: string;
+
+              /**
+               * Address line 2, such as the apartment, suite, unit, or building.
+               */
+              line2?: string;
+
+              /**
+               * ZIP or postal code.
+               */
+              postal_code: string;
+
+              /**
+               * State, county, province, or region.
+               */
+              state: string;
+            }
+          }
+
+          interface Card {
+            /**
+             * The CVC of the card.
+             */
+            cvc?: string;
+
+            /**
+             * The expiration month of the card.
+             */
+            exp_month: number;
+
+            /**
+             * The expiration year of the card.
+             */
+            exp_year: number;
+
+            /**
+             * The number of the card.
+             */
+            number: string;
+          }
+        }
+      }
+
+      interface RequestedSessionConfirmParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * The PaymentMethod to use with the requested session.
+         */
+        payment_method?: string;
+
+        /**
+         * Risk details/signals associated with the requested session
+         */
+        risk_details?: RequestedSessionConfirmParams.RiskDetails;
+      }
+
+      namespace RequestedSessionConfirmParams {
+        interface RiskDetails {
+          /**
+           * The client device metadata details for this requested session.
+           */
+          client_device_metadata_details?: RiskDetails.ClientDeviceMetadataDetails;
+        }
+
+        namespace RiskDetails {
+          interface ClientDeviceMetadataDetails {
+            /**
+             * The radar session.
+             */
+            radar_session?: string;
+
+            /**
+             * The referrer of the client device.
+             */
+            referrer?: string;
+
+            /**
+             * The remote IP address of the client device.
+             */
+            remote_ip?: string;
+
+            /**
+             * The time on page in milliseconds.
+             */
+            time_on_page_ms?: number;
+
+            /**
+             * The user agent of the client device.
+             */
+            user_agent?: string;
+          }
+        }
+      }
+
+      interface RequestedSessionExpireParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class RequestedSessionsResource {
+        /**
+         * Creates a requested session
+         */
+        create(
+          params: RequestedSessionCreateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+
+        /**
+         * Retrieves a requested session
+         */
+        retrieve(
+          id: string,
+          params?: RequestedSessionRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+
+        /**
+         * Updates a requested session
+         */
+        update(
+          id: string,
+          params?: RequestedSessionUpdateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+
+        /**
+         * Confirms a requested session
+         */
+        confirm(
+          id: string,
+          params?: RequestedSessionConfirmParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+        confirm(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+
+        /**
+         * Expires a requested session
+         */
+        expire(
+          id: string,
+          params?: RequestedSessionExpireParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+        expire(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.DelegatedCheckout.RequestedSession>>;
+      }
+    }
+  }
+}

package/types/Discounts.d.ts

@@ -26,6 +26,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+      /**
+       * The ID of the account associated with this discount.
+       */
+      customer_account?: string | null;
+
       /**
        * Always true for a deleted object
        */
@@ -105,6 +110,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+      /**
+       * The ID of the account associated with this discount.
+       */
+      customer_account?: string | null;
+
       /**
        * Always true for a deleted object
        */

package/types/Disputes.d.ts

@@ -54,6 +54,11 @@ declare module 'stripe' {
 
       evidence_details: Dispute.EvidenceDetails;
 
+      /**
+       * Intended submission method for the dispute.
+       */
+      intended_submission_method?: Dispute.IntendedSubmissionMethod | null;
+
       /**
        * If true, it's still possible to refund the disputed payment. After the payment has been fully refunded, no further funds are withdrawn from your Stripe account as a result of this dispute.
        */
@@ -86,6 +91,8 @@ declare module 'stripe' {
        */
       reason: string;
 
+      smart_disputes?: Dispute.SmartDisputes;
+
       /**
        * The current status of a dispute. Possible values include:`warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, `lost`, or `prevented`.
        */
@@ -379,6 +386,11 @@ declare module 'stripe' {
          * The number of times evidence has been submitted. Typically, you may only submit evidence once.
          */
         submission_count: number;
+
+        /**
+         * Whether the dispute was submitted manually, with Smart Disputes, or not submitted.
+         */
+        submission_method?: EvidenceDetails.SubmissionMethod;
       }
 
       namespace EvidenceDetails {
@@ -423,8 +435,16 @@ declare module 'stripe' {
             type Status = 'fee_acknowledged' | 'requires_fee_acknowledgement';
           }
         }
+
+        type SubmissionMethod = 'manual' | 'not_submitted' | 'smart_disputes';
       }
 
+      type IntendedSubmissionMethod =
+        | 'manual'
+        | 'prefer_manual'
+        | 'prefer_smart_disputes'
+        | 'smart_disputes';
+
       interface PaymentMethodDetails {
         amazon_pay?: PaymentMethodDetails.AmazonPay;
 
@@ -505,6 +525,26 @@ declare module 'stripe' {
         type Type = 'amazon_pay' | 'card' | 'klarna' | 'paypal';
       }
 
+      interface SmartDisputes {
+        /**
+         * Evidence that could be provided to improve the SmartDisputes packet
+         */
+        recommended_evidence: Array<Array<string>> | null;
+
+        /**
+         * Smart Disputes auto representment packet availability status.
+         */
+        status: SmartDisputes.Status;
+      }
+
+      namespace SmartDisputes {
+        type Status =
+          | 'available'
+          | 'processing'
+          | 'requires_evidence'
+          | 'unavailable';
+      }
+
       type Status =
         | 'lost'
         | 'needs_response'

package/types/DisputesResource.d.ts

@@ -20,6 +20,11 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
+      /**
+       * Intended submission method for the dispute.
+       */
+      intended_submission_method?: DisputeUpdateParams.IntendedSubmissionMethod;
+
       /**
        * 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`.
        */
@@ -300,6 +305,12 @@ declare module 'stripe' {
           }
         }
       }
+
+      type IntendedSubmissionMethod =
+        | 'manual'
+        | 'prefer_manual'
+        | 'prefer_smart_disputes'
+        | 'smart_disputes';
     }
 
     interface DisputeListParams extends PaginationParams {