stripe 9.2.0 → 9.3.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 9.3.0 - 2022-05-23
+* [#1430](https://github.com/stripe/stripe-node/pull/1430) API Updates
+  * Add support for new resource `Apps.Secret`
+  * Add support for `affirm` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+  * Add support for `link` on `Charge.payment_method_details`, `Mandate.payment_method_details`, `OrderCreateParams.payment.settings.payment_method_options`, `OrderUpdateParams.payment.settings.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
+  * Add support for new values `affirm` and `link` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+  * Add support for new value `link` on enums `Invoice.payment_settings.payment_method_types[]`, `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `Subscription.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+  * Add support for new values `affirm` and `link` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+  * Add support for new values `affirm` and `link` on enum `PaymentMethodCreateParams.type`
+  * Add support for new values `affirm` and `link` on enum `PaymentMethod.type`
+
 ## 9.2.0 - 2022-05-19
 * [#1422](https://github.com/stripe/stripe-node/pull/1422) API Updates
   * Add support for new `Treasury` APIs: `CreditReversal`, `DebitReversal`, `FinancialAccountFeatures`, `FinancialAccount`, `FlowDetails`, `InboundTransfer`, `OutboundPayment`, `OutboundTransfer`, `ReceivedCredit`, `ReceivedDebit`, `TransactionEntry`, and `Transaction`

package/VERSION

@@ -1 +1 @@
-9.2.0
+9.3.0

package/lib/resources/Apps/Secrets.js

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'apps/secrets',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  deleteWhere: stripeMethod({
+    method: 'POST',
+    path: '/delete',
+  }),
+
+  find: stripeMethod({
+    method: 'GET',
+    path: '/find',
+  }),
+});

package/lib/resources.js

@@ -55,6 +55,9 @@ module.exports = {
   Topups: require('./resources/Topups'),
   Transfers: require('./resources/Transfers'),
   WebhookEndpoints: require('./resources/WebhookEndpoints'),
+  Apps: resourceNamespace('apps', {
+    Secrets: require('./resources/Apps/Secrets'),
+  }),
   BillingPortal: resourceNamespace('billingPortal', {
     Configurations: require('./resources/BillingPortal/Configurations'),
     Sessions: require('./resources/BillingPortal/Sessions'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "9.2.0",
+  "version": "9.3.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/2020-08-27/Apps/Secrets.d.ts

@@ -0,0 +1,241 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Apps {
+      /**
+       * The Secret object.
+       */
+      interface Secret {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'apps.secret';
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * If true, indicates that this secret has been deleted
+         */
+        deleted?: boolean;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * A name for the secret that's unique within the scope.
+         */
+        name: string;
+
+        /**
+         * The plaintext secret value to be stored.
+         */
+        payload: string | null;
+
+        scope: Secret.Scope;
+      }
+
+      namespace Secret {
+        interface Scope {
+          /**
+           * The secret scope type.
+           */
+          type: Scope.Type;
+
+          /**
+           * The user ID, if type is set to "user"
+           */
+          user?: string;
+        }
+
+        namespace Scope {
+          type Type = 'account' | 'user';
+        }
+      }
+
+      interface SecretCreateParams {
+        /**
+         * A name for the secret that's unique within the scope.
+         */
+        name: string;
+
+        /**
+         * The plaintext secret value to be stored.
+         */
+        payload: string;
+
+        /**
+         * Specifies the scoping of the secret. Requests originating from UI extensions can only access account-scoped secrets or secrets scoped to their own user.
+         */
+        scope: SecretCreateParams.Scope;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      namespace SecretCreateParams {
+        interface Scope {
+          /**
+           * The secret scope type.
+           */
+          type: Scope.Type;
+
+          /**
+           * The user ID. This field is required if `type` is set to `user`, and should not be provided if `type` is set to `account`.
+           */
+          user?: string;
+        }
+
+        namespace Scope {
+          type Type = 'account' | 'user';
+        }
+      }
+
+      interface SecretListParams extends PaginationParams {
+        /**
+         * Specifies the scoping of the secret. Requests originating from UI extensions can only access account-scoped secrets or secrets scoped to their own user.
+         */
+        scope: SecretListParams.Scope;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      namespace SecretListParams {
+        interface Scope {
+          /**
+           * The secret scope type.
+           */
+          type: Scope.Type;
+
+          /**
+           * The user ID. This field is required if `type` is set to `user`, and should not be provided if `type` is set to `account`.
+           */
+          user?: string;
+        }
+
+        namespace Scope {
+          type Type = 'account' | 'user';
+        }
+      }
+
+      interface SecretDeleteWhereParams {
+        /**
+         * A name for the secret that's unique within the scope.
+         */
+        name: string;
+
+        /**
+         * Specifies the scoping of the secret. Requests originating from UI extensions can only access account-scoped secrets or secrets scoped to their own user.
+         */
+        scope: SecretDeleteWhereParams.Scope;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      namespace SecretDeleteWhereParams {
+        interface Scope {
+          /**
+           * The secret scope type.
+           */
+          type: Scope.Type;
+
+          /**
+           * The user ID. This field is required if `type` is set to `user`, and should not be provided if `type` is set to `account`.
+           */
+          user?: string;
+        }
+
+        namespace Scope {
+          type Type = 'account' | 'user';
+        }
+      }
+
+      interface SecretFindParams {
+        /**
+         * A name for the secret that's unique within the scope.
+         */
+        name: string;
+
+        /**
+         * Specifies the scoping of the secret. Requests originating from UI extensions can only access account-scoped secrets or secrets scoped to their own user.
+         */
+        scope: SecretFindParams.Scope;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      namespace SecretFindParams {
+        interface Scope {
+          /**
+           * The secret scope type.
+           */
+          type: Scope.Type;
+
+          /**
+           * The user ID. This field is required if `type` is set to `user`, and should not be provided if `type` is set to `account`.
+           */
+          user?: string;
+        }
+
+        namespace Scope {
+          type Type = 'account' | 'user';
+        }
+      }
+
+      class SecretsResource {
+        /**
+         * Create or replace a secret in the secret store.
+         */
+        create(
+          params: SecretCreateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Apps.Secret>>;
+
+        /**
+         * List all secrets stored on the given scope.
+         */
+        list(
+          params: SecretListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Apps.Secret>;
+
+        /**
+         * Deletes a secret from the secret store by name and scope.
+         */
+        deleteWhere(
+          params: SecretDeleteWhereParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Apps.Secret>>;
+
+        /**
+         * Finds a secret in the secret store by name and scope.
+         */
+        find(
+          params: SecretFindParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Apps.Secret>>;
+      }
+    }
+  }
+}

package/types/2020-08-27/Charges.d.ts

@@ -388,6 +388,8 @@ declare module 'stripe' {
 
         acss_debit?: PaymentMethodDetails.AcssDebit;
 
+        affirm?: PaymentMethodDetails.Affirm;
+
         afterpay_clearpay?: PaymentMethodDetails.AfterpayClearpay;
 
         alipay?: PaymentMethodDetails.Alipay;
@@ -422,6 +424,8 @@ declare module 'stripe' {
 
         konbini?: PaymentMethodDetails.Konbini;
 
+        link?: PaymentMethodDetails.Link;
+
         multibanco?: PaymentMethodDetails.Multibanco;
 
         oxxo?: PaymentMethodDetails.Oxxo;
@@ -543,6 +547,8 @@ declare module 'stripe' {
           transit_number: string | null;
         }
 
+        interface Affirm {}
+
         interface AfterpayClearpay {
           /**
            * Order identifier shown to the merchant in Afterpay's online portal.
@@ -1469,6 +1475,8 @@ declare module 'stripe' {
           }
         }
 
+        interface Link {}
+
         interface Multibanco {
           /**
            * Entity number associated with this Multibanco payment.

package/types/2020-08-27/Customers.d.ts

@@ -810,6 +810,7 @@ declare module 'stripe' {
     namespace CustomerListPaymentMethodsParams {
       type Type =
         | 'acss_debit'
+        | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
         | 'au_becs_debit'
@@ -826,6 +827,7 @@ declare module 'stripe' {
         | 'ideal'
         | 'klarna'
         | 'konbini'
+        | 'link'
         | 'oxxo'
         | 'p24'
         | 'paynow'

package/types/2020-08-27/Invoices.d.ts

@@ -745,6 +745,7 @@ declare module 'stripe' {
           | 'grabpay'
           | 'ideal'
           | 'konbini'
+          | 'link'
           | 'paynow'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -1193,6 +1194,7 @@ declare module 'stripe' {
           | 'grabpay'
           | 'ideal'
           | 'konbini'
+          | 'link'
           | 'paynow'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -1533,6 +1535,7 @@ declare module 'stripe' {
           | 'grabpay'
           | 'ideal'
           | 'konbini'
+          | 'link'
           | 'paynow'
           | 'sepa_credit_transfer'
           | 'sepa_debit'

package/types/2020-08-27/Mandates.d.ts

@@ -91,6 +91,8 @@ declare module 'stripe' {
 
         card?: PaymentMethodDetails.Card;
 
+        link?: PaymentMethodDetails.Link;
+
         sepa_debit?: PaymentMethodDetails.SepaDebit;
 
         /**
@@ -162,6 +164,8 @@ declare module 'stripe' {
 
         interface Card {}
 
+        interface Link {}
+
         interface SepaDebit {
           /**
            * The unique reference of the mandate.

package/types/2020-08-27/Orders.d.ts

@@ -1161,6 +1161,11 @@ declare module 'stripe' {
              */
             klarna?: PaymentMethodOptions.Klarna;
 
+            /**
+             * If paying by `link`, this sub-hash contains details about the Link payment method options to pass to the order's PaymentIntent.
+             */
+            link?: PaymentMethodOptions.Link;
+
             /**
              * If paying by `oxxo`, this sub-hash contains details about the OXXO payment method options to pass to the order's PaymentIntent.
              */
@@ -1464,6 +1469,37 @@ declare module 'stripe' {
                 | 'sv-SE';
             }
 
+            interface Link {
+              /**
+               * Controls when the funds will be captured from the customer's account.
+               *
+               * If provided, this parameter will override the top-level `capture_method` when finalizing the payment with this payment method type.
+               *
+               * If `capture_method` is already set on the PaymentIntent, providing an empty value for this parameter will unset the stored value for this payment method type.
+               */
+              capture_method?: Stripe.Emptyable<'manual'>;
+
+              /**
+               * Token used for persistent Link logins.
+               */
+              persistent_token?: string;
+
+              /**
+               * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+               *
+               * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+               *
+               * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+               *
+               * If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`.
+               */
+              setup_future_usage?: Stripe.Emptyable<Link.SetupFutureUsage>;
+            }
+
+            namespace Link {
+              type SetupFutureUsage = 'none' | 'off_session';
+            }
+
             interface Oxxo {
               /**
                * The number of calendar days before an OXXO voucher expires. For example, if you create an OXXO voucher on Monday and you set expires_after_days to 2, the OXXO invoice will expire on Wednesday at 23:59 America/Mexico_City time.
@@ -2145,6 +2181,11 @@ declare module 'stripe' {
              */
             klarna?: Stripe.Emptyable<PaymentMethodOptions.Klarna>;
 
+            /**
+             * If paying by `link`, this sub-hash contains details about the Link payment method options to pass to the order's PaymentIntent.
+             */
+            link?: Stripe.Emptyable<PaymentMethodOptions.Link>;
+
             /**
              * If paying by `oxxo`, this sub-hash contains details about the OXXO payment method options to pass to the order's PaymentIntent.
              */
@@ -2448,6 +2489,37 @@ declare module 'stripe' {
                 | 'sv-SE';
             }
 
+            interface Link {
+              /**
+               * Controls when the funds will be captured from the customer's account.
+               *
+               * If provided, this parameter will override the top-level `capture_method` when finalizing the payment with this payment method type.
+               *
+               * If `capture_method` is already set on the PaymentIntent, providing an empty value for this parameter will unset the stored value for this payment method type.
+               */
+              capture_method?: Stripe.Emptyable<'manual'>;
+
+              /**
+               * Token used for persistent Link logins.
+               */
+              persistent_token?: string;
+
+              /**
+               * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+               *
+               * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+               *
+               * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+               *
+               * If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`.
+               */
+              setup_future_usage?: Stripe.Emptyable<Link.SetupFutureUsage>;
+            }
+
+            namespace Link {
+              type SetupFutureUsage = 'none' | 'off_session';
+            }
+
             interface Oxxo {
               /**
                * The number of calendar days before an OXXO voucher expires. For example, if you create an OXXO voucher on Monday and you set expires_after_days to 2, the OXXO invoice will expire on Wednesday at 23:59 America/Mexico_City time.