stripe 9.2.0 → 9.5.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # CHANGELOG
 
+## 9.5.0 - 2022-05-26
+* [#1434](https://github.com/stripe/stripe-node/pull/1434) API Updates
+  * Add support for `affirm_payments` and `link_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+  * Add support for `id_number_secondary` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
+  * Add support for new value `affirm` on enum `CheckoutSessionCreateParams.payment_method_types[]`
+  * Add support for `hosted_instructions_url` on `PaymentIntent.next_action.display_bank_transfer_instructions`
+  * Add support for `id_number_secondary_provided` on `Person`
+  * Add support for `card_issuing` on `TreasuryFinancialAccountCreateParams.features`, `TreasuryFinancialAccountUpdateFeaturesParams`, and `TreasuryFinancialAccountUpdateParams.features`
+  
+* [#1432](https://github.com/stripe/stripe-node/pull/1432) docs: Update HttpClient documentation to remove experimental status.
+
+## 9.4.0 - 2022-05-23
+* [#1431](https://github.com/stripe/stripe-node/pull/1431) API Updates
+  * Add support for `treasury` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+
+## 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.5.0

package/lib/net/HttpClient.js

@@ -1,8 +1,13 @@
 'use strict';
 
 /**
- * Encapsulates the logic for issuing a request to the Stripe API. This is an
- * experimental interface and is not yet stable.
+ * Encapsulates the logic for issuing a request to the Stripe API.
+ *
+ * A custom HTTP client should should implement:
+ * 1. A response class which extends HttpClientResponse and wraps around their
+ *    own internal representation of a response.
+ * 2. A client class which extends HttpClient and implements all methods,
+ *    returning their own response class when making requests.
  */
 class HttpClient {
   /** The client name used for diagnostics. */

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.5.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

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

@@ -161,6 +161,11 @@ declare module 'stripe' {
          */
         acss_debit_payments?: Capabilities.AcssDebitPayments;
 
+        /**
+         * The status of the Affirm capability of the account, or whether the account can directly process Affirm charges.
+         */
+        affirm_payments?: Capabilities.AffirmPayments;
+
         /**
          * The status of the Afterpay Clearpay capability of the account, or whether the account can directly process Afterpay Clearpay charges.
          */
@@ -251,6 +256,11 @@ declare module 'stripe' {
          */
         legacy_payments?: Capabilities.LegacyPayments;
 
+        /**
+         * The status of the link_payments capability of the account, or whether the account can directly process Link charges.
+         */
+        link_payments?: Capabilities.LinkPayments;
+
         /**
          * The status of the OXXO payments capability of the account, or whether the account can directly process OXXO charges.
          */
@@ -291,6 +301,11 @@ declare module 'stripe' {
          */
         transfers?: Capabilities.Transfers;
 
+        /**
+         * The status of the banking capability, or whether the account can have bank accounts.
+         */
+        treasury?: Capabilities.Treasury;
+
         /**
          * The status of the US bank account ACH payments capability of the account, or whether the account can directly process US bank account charges.
          */
@@ -300,6 +315,8 @@ declare module 'stripe' {
       namespace Capabilities {
         type AcssDebitPayments = 'active' | 'inactive' | 'pending';
 
+        type AffirmPayments = 'active' | 'inactive' | 'pending';
+
         type AfterpayClearpayPayments = 'active' | 'inactive' | 'pending';
 
         type AuBecsDebitPayments = 'active' | 'inactive' | 'pending';
@@ -336,6 +353,8 @@ declare module 'stripe' {
 
         type LegacyPayments = 'active' | 'inactive' | 'pending';
 
+        type LinkPayments = 'active' | 'inactive' | 'pending';
+
         type OxxoPayments = 'active' | 'inactive' | 'pending';
 
         type P24Payments = 'active' | 'inactive' | 'pending';
@@ -352,6 +371,8 @@ declare module 'stripe' {
 
         type Transfers = 'active' | 'inactive' | 'pending';
 
+        type Treasury = 'active' | 'inactive' | 'pending';
+
         type UsBankAccountAchPayments = 'active' | 'inactive' | 'pending';
       }
 
@@ -1196,6 +1217,11 @@ declare module 'stripe' {
          */
         acss_debit_payments?: Capabilities.AcssDebitPayments;
 
+        /**
+         * The affirm_payments capability.
+         */
+        affirm_payments?: Capabilities.AffirmPayments;
+
         /**
          * The afterpay_clearpay_payments capability.
          */
@@ -1286,6 +1312,11 @@ declare module 'stripe' {
          */
         legacy_payments?: Capabilities.LegacyPayments;
 
+        /**
+         * The link_payments capability.
+         */
+        link_payments?: Capabilities.LinkPayments;
+
         /**
          * The oxxo_payments capability.
          */
@@ -1326,6 +1357,11 @@ declare module 'stripe' {
          */
         transfers?: Capabilities.Transfers;
 
+        /**
+         * The treasury capability.
+         */
+        treasury?: Capabilities.Treasury;
+
         /**
          * The us_bank_account_ach_payments capability.
          */
@@ -1340,6 +1376,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface AffirmPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface AfterpayClearpayPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -1466,6 +1509,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface LinkPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface OxxoPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -1522,6 +1572,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface Treasury {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface UsBankAccountAchPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -1864,6 +1921,11 @@ declare module 'stripe' {
          */
         id_number?: string;
 
+        /**
+         * The government-issued secondary ID number of the individual, as appropriate for the representative's country, will be used for enhanced verification checks. In Thailand, this would be the laser code found on the back of an ID card. Instead of the number itself, you can also provide a [PII token created with Stripe.js](https://stripe.com/docs/js/tokens_sources/create_token?type=pii).
+         */
+        id_number_secondary?: string;
+
         /**
          * The individual's last name.
          */
@@ -2323,6 +2385,11 @@ declare module 'stripe' {
          */
         acss_debit_payments?: Capabilities.AcssDebitPayments;
 
+        /**
+         * The affirm_payments capability.
+         */
+        affirm_payments?: Capabilities.AffirmPayments;
+
         /**
          * The afterpay_clearpay_payments capability.
          */
@@ -2413,6 +2480,11 @@ declare module 'stripe' {
          */
         legacy_payments?: Capabilities.LegacyPayments;
 
+        /**
+         * The link_payments capability.
+         */
+        link_payments?: Capabilities.LinkPayments;
+
         /**
          * The oxxo_payments capability.
          */
@@ -2453,6 +2525,11 @@ declare module 'stripe' {
          */
         transfers?: Capabilities.Transfers;
 
+        /**
+         * The treasury capability.
+         */
+        treasury?: Capabilities.Treasury;
+
         /**
          * The us_bank_account_ach_payments capability.
          */
@@ -2467,6 +2544,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface AffirmPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface AfterpayClearpayPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -2593,6 +2677,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface LinkPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface OxxoPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -2649,6 +2740,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface Treasury {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface UsBankAccountAchPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -2954,6 +3052,11 @@ declare module 'stripe' {
          */
         id_number?: string;
 
+        /**
+         * The government-issued secondary ID number of the individual, as appropriate for the representative's country, will be used for enhanced verification checks. In Thailand, this would be the laser code found on the back of an ID card. Instead of the number itself, you can also provide a [PII token created with Stripe.js](https://stripe.com/docs/js/tokens_sources/create_token?type=pii).
+         */
+        id_number_secondary?: string;
+
         /**
          * The individual's last name.
          */

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/Checkout/Sessions.d.ts

@@ -1770,6 +1770,7 @@ declare module 'stripe' {
 
         type PaymentMethodType =
           | 'acss_debit'
+          | 'affirm'
           | 'afterpay_clearpay'
           | 'alipay'
           | 'au_becs_debit'

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.