stripe 17.5.0 → 17.6.0-beta.2

package/types/Tax/AssociationsResource.d.ts

@@ -0,0 +1,29 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Tax {
+      interface AssociationFindParams {
+        /**
+         * Valid [PaymentIntent](https://stripe.com/docs/api/payment_intents/object) id
+         */
+        payment_intent: string;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class AssociationsResource {
+        /**
+         * Finds a tax association object by PaymentIntent id.
+         */
+        find(
+          params: AssociationFindParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Tax.Association>>;
+      }
+    }
+  }
+}

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/Terminal/Configurations.d.ts

@@ -101,6 +101,8 @@ declare module 'stripe' {
 
           hkd?: Tipping.Hkd;
 
+          jpy?: Tipping.Jpy;
+
           myr?: Tipping.Myr;
 
           nok?: Tipping.Nok;
@@ -253,6 +255,23 @@ declare module 'stripe' {
             smart_tip_threshold?: number;
           }
 
+          interface Jpy {
+            /**
+             * Fixed amounts displayed when collecting a tip
+             */
+            fixed_amounts?: Array<number> | null;
+
+            /**
+             * Percentages displayed when collecting a tip
+             */
+            percentages?: Array<number> | null;
+
+            /**
+             * Below this amount, fixed amounts will be displayed; above it, percentages will be displayed
+             */
+            smart_tip_threshold?: number;
+          }
+
           interface Myr {
             /**
              * Fixed amounts displayed when collecting a tip

package/types/Terminal/ConfigurationsResource.d.ts

@@ -120,6 +120,11 @@ declare module 'stripe' {
            */
           hkd?: Tipping.Hkd;
 
+          /**
+           * Tipping configuration for JPY
+           */
+          jpy?: Tipping.Jpy;
+
           /**
            * Tipping configuration for MYR
            */
@@ -293,6 +298,23 @@ declare module 'stripe' {
             smart_tip_threshold?: number;
           }
 
+          interface Jpy {
+            /**
+             * Fixed amounts displayed when collecting a tip
+             */
+            fixed_amounts?: Array<number>;
+
+            /**
+             * Percentages displayed when collecting a tip
+             */
+            percentages?: Array<number>;
+
+            /**
+             * Below this amount, fixed amounts will be displayed; above it, percentages will be displayed
+             */
+            smart_tip_threshold?: number;
+          }
+
           interface Myr {
             /**
              * Fixed amounts displayed when collecting a tip
@@ -551,6 +573,11 @@ declare module 'stripe' {
            */
           hkd?: Tipping.Hkd;
 
+          /**
+           * Tipping configuration for JPY
+           */
+          jpy?: Tipping.Jpy;
+
           /**
            * Tipping configuration for MYR
            */
@@ -724,6 +751,23 @@ declare module 'stripe' {
             smart_tip_threshold?: number;
           }
 
+          interface Jpy {
+            /**
+             * Fixed amounts displayed when collecting a tip
+             */
+            fixed_amounts?: Array<number>;
+
+            /**
+             * Percentages displayed when collecting a tip
+             */
+            percentages?: Array<number>;
+
+            /**
+             * Below this amount, fixed amounts will be displayed; above it, percentages will be displayed
+             */
+            smart_tip_threshold?: number;
+          }
+
           interface Myr {
             /**
              * Fixed amounts displayed when collecting a tip

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>>;
+      }
+    }
+  }
+}