stripe 20.0.0 → 20.1.0-alpha.1

package/types/Tax/Forms.d.ts

@@ -0,0 +1,220 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Tax {
+      /**
+       * Tax forms are legal documents which are delivered to one or more tax authorities for information reporting purposes.
+       *
+       * Related guide: [US tax reporting for Connect platforms](https://stripe.com/docs/connect/tax-reporting)
+       */
+      interface Form {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'tax.form';
+
+        au_serr?: Form.AuSerr;
+
+        ca_mrdp?: Form.CaMrdp;
+
+        /**
+         * The form that corrects this form, if any.
+         */
+        corrected_by: string | Stripe.Tax.Form | null;
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        eu_dac7?: Form.EuDac7;
+
+        /**
+         * A list of tax filing statuses. Note that a filing status will only be included if the form has been filed directly with the jurisdiction's tax authority.
+         */
+        filing_statuses: Array<Form.FilingStatus>;
+
+        gb_mrdp?: Form.GbMrdp;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        nz_mrdp?: Form.NzMrdp;
+
+        payee: Form.Payee;
+
+        /**
+         * The type of the tax form. An additional hash is included on the tax form with a name matching this value. It contains additional information specific to the tax form type.
+         */
+        type: Form.Type;
+
+        us_1099_k?: Form.Us1099K;
+
+        us_1099_misc?: Form.Us1099Misc;
+
+        us_1099_nec?: Form.Us1099Nec;
+      }
+
+      namespace Form {
+        interface AuSerr {
+          /**
+           * End date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_end_date: string;
+
+          /**
+           * Start date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_start_date: string;
+        }
+
+        interface CaMrdp {
+          /**
+           * End date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_end_date: string;
+
+          /**
+           * Start date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_start_date: string;
+        }
+
+        interface EuDac7 {
+          /**
+           * End date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_end_date: string;
+
+          /**
+           * Start date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_start_date: string;
+        }
+
+        interface FilingStatus {
+          /**
+           * Time when the filing status was updated.
+           */
+          effective_at: number;
+
+          jurisdiction: FilingStatus.Jurisdiction;
+
+          /**
+           * The current status of the filed form.
+           */
+          value: FilingStatus.Value;
+        }
+
+        namespace FilingStatus {
+          interface Jurisdiction {
+            /**
+             * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+             */
+            country: string;
+
+            /**
+             * Indicates the level of the jurisdiction where the form was filed.
+             */
+            level: Jurisdiction.Level;
+
+            /**
+             * [ISO 3166-2 U.S. state code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix, if any. For example, "NY" for New York, United States. Null for non-U.S. forms.
+             */
+            state: string | null;
+          }
+
+          namespace Jurisdiction {
+            type Level = 'country' | 'state';
+          }
+
+          type Value = 'accepted' | 'filed' | 'rejected';
+        }
+
+        interface GbMrdp {
+          /**
+           * End date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_end_date: string;
+
+          /**
+           * Start date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_start_date: string;
+        }
+
+        interface NzMrdp {
+          /**
+           * End date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_end_date: string;
+
+          /**
+           * Start date of the period represented by the information reported on the tax form.
+           */
+          reporting_period_start_date: string;
+        }
+
+        interface Payee {
+          /**
+           * The ID of the payee's Stripe account.
+           */
+          account: string | Stripe.Account | null;
+
+          /**
+           * The external reference to this payee.
+           */
+          external_reference: string | null;
+
+          /**
+           * Either `account` or `external_reference`.
+           */
+          type: Payee.Type;
+        }
+
+        namespace Payee {
+          type Type = 'account' | 'external_reference';
+        }
+
+        type Type =
+          | 'au_serr'
+          | 'ca_mrdp'
+          | 'eu_dac7'
+          | 'gb_mrdp'
+          | 'nz_mrdp'
+          | 'us_1099_k'
+          | 'us_1099_misc'
+          | 'us_1099_nec';
+
+        interface Us1099K {
+          /**
+           * Year represented by the information reported on the tax form.
+           */
+          reporting_year: number;
+        }
+
+        interface Us1099Misc {
+          /**
+           * Year represented by the information reported on the tax form.
+           */
+          reporting_year: number;
+        }
+
+        interface Us1099Nec {
+          /**
+           * Year represented by the information reported on the tax form.
+           */
+          reporting_year: number;
+        }
+      }
+    }
+  }
+}

package/types/Tax/FormsResource.d.ts

@@ -0,0 +1,107 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Tax {
+      interface FormRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface FormListParams extends PaginationParams {
+        /**
+         * The payee whose volume is represented on the tax form.
+         */
+        payee: FormListParams.Payee;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * An optional filter on the list, based on the object `type` field. Without the filter, the list includes all current and future tax form types. If your integration expects only one type of tax form in the response, make sure to provide a type value in the request.
+         */
+        type?: FormListParams.Type;
+      }
+
+      namespace FormListParams {
+        interface Payee {
+          /**
+           * The ID of the Stripe account whose forms will be retrieved.
+           */
+          account?: string;
+
+          /**
+           * The external reference to the payee whose forms will be retrieved.
+           */
+          external_reference?: string;
+
+          /**
+           * Specifies the payee type. Either `account` or `external_reference`.
+           */
+          type?: Payee.Type;
+        }
+
+        namespace Payee {
+          type Type = 'account' | 'external_reference';
+        }
+
+        type Type =
+          | 'au_serr'
+          | 'ca_mrdp'
+          | 'eu_dac7'
+          | 'gb_mrdp'
+          | 'nz_mrdp'
+          | 'us_1099_k'
+          | 'us_1099_misc'
+          | 'us_1099_nec';
+      }
+
+      interface FormPdfParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class FormsResource {
+        /**
+         * Retrieves the details of a tax form that has previously been created. Supply the unique tax form ID that was returned from your previous request, and Stripe will return the corresponding tax form information.
+         */
+        retrieve(
+          id: string,
+          params?: FormRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Tax.Form>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Tax.Form>>;
+
+        /**
+         * Returns a list of tax forms which were previously created. The tax forms are returned in sorted order, with the oldest tax forms appearing first.
+         */
+        list(
+          params: FormListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Tax.Form>;
+
+        /**
+         * Download the PDF for a tax form.
+         */
+        pdf(
+          id: string,
+          params?: FormPdfParams,
+          options?: RequestOptions
+        ): Promise<StripeStreamResponse>;
+        pdf(
+          id: string,
+          options?: RequestOptions
+        ): Promise<StripeStreamResponse>;
+      }
+    }
+  }
+}

package/types/TaxIds.d.ts

@@ -54,6 +54,11 @@ declare module 'stripe' {
        */
       customer: string | Stripe.Customer | null;
 
+      /**
+       * ID of the account.
+       */
+      customer_account?: string | null;
+
       /**
        * Always true for a deleted object
        */
@@ -102,6 +107,11 @@ declare module 'stripe' {
          */
         customer?: string | Stripe.Customer;
 
+        /**
+         * The account being referenced when `type` is `customer`.
+         */
+        customer_account?: string | null;
+
         /**
          * Type of owner referenced.
          */

package/types/TaxIdsResource.d.ts

@@ -36,6 +36,11 @@ declare module 'stripe' {
          */
         customer?: string;
 
+        /**
+         * v2 Account the tax ID belongs to. Can be used in place of `customer` when `type=customer`
+         */
+        customer_account?: string;
+
         /**
          * Type of owner referenced.
          */
@@ -190,6 +195,11 @@ declare module 'stripe' {
          */
         customer?: string;
 
+        /**
+         * v2 Account the tax ID belongs to. Can be used in place of `customer` when `type=customer`
+         */
+        customer_account?: string;
+
         /**
          * Type of owner referenced.
          */

package/types/Terminal/Configurations.d.ts

@@ -44,6 +44,8 @@ declare module 'stripe' {
 
         offline?: Configuration.Offline;
 
+        reader_security?: Configuration.ReaderSecurity;
+
         reboot_window?: Configuration.RebootWindow;
 
         stripe_s700?: Configuration.StripeS700;
@@ -77,6 +79,13 @@ declare module 'stripe' {
           enabled: boolean | null;
         }
 
+        interface ReaderSecurity {
+          /**
+           * Passcode used to access a reader's admin menu.
+           */
+          admin_menu_passcode: string;
+        }
+
         interface RebootWindow {
           /**
            * Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour.

package/types/Terminal/ConfigurationsResource.d.ts

@@ -29,6 +29,13 @@ declare module 'stripe' {
          */
         offline?: Stripe.Emptyable<ConfigurationCreateParams.Offline>;
 
+        /**
+         * Configurations for reader security settings.
+         */
+        reader_security?: Stripe.Emptyable<
+          ConfigurationCreateParams.ReaderSecurity
+        >;
+
         /**
          * Reboot time settings for readers. that support customized reboot time configuration.
          */
@@ -77,6 +84,13 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface ReaderSecurity {
+          /**
+           * Passcode used to access a reader's admin menu.
+           */
+          admin_menu_passcode?: Stripe.Emptyable<string>;
+        }
+
         interface RebootWindow {
           /**
            * Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour.
@@ -719,6 +733,13 @@ declare module 'stripe' {
          */
         offline?: Stripe.Emptyable<ConfigurationUpdateParams.Offline>;
 
+        /**
+         * Configurations for reader security settings.
+         */
+        reader_security?: Stripe.Emptyable<
+          ConfigurationUpdateParams.ReaderSecurity
+        >;
+
         /**
          * Reboot time settings for readers. that support customized reboot time configuration.
          */
@@ -771,6 +792,13 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface ReaderSecurity {
+          /**
+           * Passcode used to access a reader's admin menu.
+           */
+          admin_menu_passcode?: Stripe.Emptyable<string>;
+        }
+
         interface RebootWindow {
           /**
            * Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour.

package/types/Terminal/ReaderCollectedData.d.ts

@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Terminal {
+      /**
+       * Returns data collected by Terminal readers. This data is only stored for 24 hours.
+       */
+      interface ReaderCollectedData {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'terminal.reader_collected_data';
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: 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;
+
+        /**
+         * The magstripe data collected by the reader.
+         */
+        magstripe: ReaderCollectedData.Magstripe | null;
+
+        /**
+         * The type of data collected by the reader.
+         */
+        type: 'magstripe';
+      }
+
+      namespace ReaderCollectedData {
+        interface Magstripe {
+          /**
+           * The raw magstripe data collected by the reader.
+           */
+          data: string | null;
+        }
+      }
+    }
+  }
+}

package/types/Terminal/ReaderCollectedDataResource.d.ts

@@ -0,0 +1,29 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Terminal {
+      interface ReaderCollectedDataRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class ReaderCollectedDataResource {
+        /**
+         * Retrieve data collected using Reader hardware.
+         */
+        retrieve(
+          id: string,
+          params?: ReaderCollectedDataRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Terminal.ReaderCollectedData>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Terminal.ReaderCollectedData>>;
+      }
+    }
+  }
+}

package/types/Terminal/Readers.d.ts

@@ -366,6 +366,11 @@ declare module 'stripe' {
           }
 
           interface CollectPaymentMethod {
+            /**
+             * Account the payment intent belongs to.
+             */
+            account?: string;
+
             /**
              * Represents a per-transaction override of a reader configuration
              */
@@ -415,6 +420,11 @@ declare module 'stripe' {
           }
 
           interface ConfirmPaymentIntent {
+            /**
+             * Account the payment intent belongs to.
+             */
+            account?: string;
+
             /**
              * Represents a per-transaction override of a reader configuration
              */
@@ -436,6 +446,11 @@ declare module 'stripe' {
           }
 
           interface ProcessPaymentIntent {
+            /**
+             * Account the payment intent belongs to.
+             */
+            account?: string;
+
             /**
              * Most recent PaymentIntent processed by the reader.
              */
@@ -507,6 +522,11 @@ declare module 'stripe' {
           }
 
           interface RefundPayment {
+            /**
+             * Account the payment intent belongs to.
+             */
+            account?: string;
+
             /**
              * The amount being refunded.
              */