stripe 8.217.0 → 8.220.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # CHANGELOG
 
+## 8.220.0 - 2022-05-03
+* [#1407](https://github.com/stripe/stripe-node/pull/1407) API Updates
+  * Add support for new resource `CashBalance`
+  * Change type of `BillingPortal.Configuration.application` from `$Application` to `deletable($Application)`
+  * Add support for `alipay` on `Checkout.Session.payment_method_options` and `CheckoutSessionCreateParams.payment_method_options`
+  * Change type of `CheckoutSessionCreateParams.payment_method_options.konbini.expires_after_days` from `emptyStringable(integer)` to `integer`
+  * Add support for new value `eu_oss_vat` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, and `TaxId.type`
+  * Add support for new value `eu_oss_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+  * Add support for `cash_balance` on `Customer`
+  * Add support for `application` on `Invoice`, `Quote`, `SubscriptionSchedule`, and `Subscription`
+* [#1403](https://github.com/stripe/stripe-node/pull/1403) Add tests for specifying a custom host on StripeMethod.
+
+## 8.219.0 - 2022-04-21
+* [#1398](https://github.com/stripe/stripe-node/pull/1398) API Updates
+  * Add support for `expire` test helper method on resource `Refund`
+  * Change type of `BillingPortal.Configuration.application` from `string` to `expandable($Application)`
+  * Change `IssuingDisputeCreateParams.transaction` to be optional
+
+## 8.218.0 - 2022-04-18
+* [#1396](https://github.com/stripe/stripe-node/pull/1396) API Updates
+  * Add support for new resources `FundingInstructions` and `Terminal.Configuration`
+  * Add support for `create_funding_instructions` method on resource `Customer`
+  * Add support for new value `customer_balance` as a payment method `type`.
+  * Add support for `customer_balance` 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`, and `PaymentMethod`
+  * Add support for `cash_balance` on `CustomerCreateParams` and `CustomerUpdateParams`
+  * Add support for `amount_details` on `PaymentIntent`
+  * Add support for `display_bank_transfer_instructions` on `PaymentIntent.next_action`
+  * Add support for `configuration_overrides` on `Terminal.Location`, `TerminalLocationCreateParams`, and `TerminalLocationUpdateParams`
+
 ## 8.217.0 - 2022-04-13
 * [#1395](https://github.com/stripe/stripe-node/pull/1395) API Updates
   * Add support for `increment_authorization` method on resource `PaymentIntent`

package/VERSION

@@ -1 +1 @@
-8.217.0
+8.220.0

package/lib/resources/Customers.js

@@ -34,6 +34,11 @@ module.exports = StripeResource.extend({
     path: '/{customer}',
   }),
 
+  createFundingInstructions: stripeMethod({
+    method: 'POST',
+    path: '/{customer}/funding_instructions',
+  }),
+
   deleteDiscount: stripeMethod({
     method: 'DELETE',
     path: '/{customer}/discount',
@@ -51,6 +56,16 @@ module.exports = StripeResource.extend({
     methodType: 'search',
   }),
 
+  retrieveCashBalance: stripeMethod({
+    method: 'GET',
+    path: '/{customer}/cash_balance',
+  }),
+
+  updateCashBalance: stripeMethod({
+    method: 'POST',
+    path: '/{customer}/cash_balance',
+  }),
+
   createBalanceTransaction: stripeMethod({
     method: 'POST',
     path: '/{customer}/balance_transactions',

package/lib/resources/Terminal/Configurations.js

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'terminal/configurations',
+
+  create: stripeMethod({
+    method: 'POST',
+    path: '',
+  }),
+
+  retrieve: stripeMethod({
+    method: 'GET',
+    path: '/{configuration}',
+  }),
+
+  update: stripeMethod({
+    method: 'POST',
+    path: '/{configuration}',
+  }),
+
+  list: stripeMethod({
+    method: 'GET',
+    path: '',
+    methodType: 'list',
+  }),
+
+  del: stripeMethod({
+    method: 'DELETE',
+    path: '/{configuration}',
+  }),
+});

package/lib/resources/TestHelpers/Refunds.js

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec
+
+'use strict';
+
+const StripeResource = require('../../StripeResource');
+const stripeMethod = StripeResource.method;
+
+module.exports = StripeResource.extend({
+  path: 'test_helpers/refunds',
+
+  expire: stripeMethod({
+    method: 'POST',
+    path: '/{refund}/expire',
+  }),
+});

package/lib/resources.js

@@ -87,11 +87,13 @@ module.exports = {
     ScheduledQueryRuns: require('./resources/Sigma/ScheduledQueryRuns'),
   }),
   Terminal: resourceNamespace('terminal', {
+    Configurations: require('./resources/Terminal/Configurations'),
     ConnectionTokens: require('./resources/Terminal/ConnectionTokens'),
     Locations: require('./resources/Terminal/Locations'),
     Readers: require('./resources/Terminal/Readers'),
   }),
   TestHelpers: resourceNamespace('testHelpers', {
+    Refunds: require('./resources/TestHelpers/Refunds'),
     TestClocks: require('./resources/TestHelpers/TestClocks'),
     Terminal: resourceNamespace('terminal', {
       Readers: require('./resources/TestHelpers/Terminal/Readers'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "8.217.0",
+  "version": "8.220.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",
@@ -57,7 +57,7 @@
     "clean": "rm -rf ./.nyc_output ./node_modules/.cache ./coverage",
     "mocha": "nyc mocha --config=test/.mocharc.js",
     "mocha-only": "mocha --config=test/.mocharc.js",
-    "test": "yarn lint && yarn test-typescript && yarn mocha",
+    "test": "yarn test-typescript && yarn mocha",
     "test-typescript": "tsc --build types/test",
     "lint": "eslint --ext .js,.jsx,.ts .",
     "fix": "yarn lint --fix && ./scripts/updateAPIVersion.js",

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

@@ -16,6 +16,33 @@ declare module 'stripe' {
        */
       object: 'application';
 
+      deleted?: void;
+
+      /**
+       * The name of the application.
+       */
+      name: string | null;
+    }
+
+    /**
+     * The DeletedApplication object.
+     */
+    interface DeletedApplication {
+      /**
+       * Unique identifier for the object.
+       */
+      id: string;
+
+      /**
+       * String representing the object's type. Objects of the same type share the same value.
+       */
+      object: 'application';
+
+      /**
+       * Always true for a deleted object
+       */
+      deleted: true;
+
       /**
        * The name of the application.
        */

package/types/2020-08-27/BillingPortal/Configurations.d.ts

@@ -25,7 +25,11 @@ declare module 'stripe' {
         /**
          * ID of the Connect Application that created the configuration.
          */
-        application: string | null;
+        application:
+          | string
+          | Stripe.Application
+          | Stripe.DeletedApplication
+          | null;
 
         business_profile: Configuration.BusinessProfile;
 

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

@@ -0,0 +1,83 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    /**
+     * The CashBalance object.
+     */
+    interface CashBalance {
+      /**
+       * String representing the object's type. Objects of the same type share the same value.
+       */
+      object: 'cash_balance';
+
+      /**
+       * A hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0.
+       */
+      available: {
+        [key: string]: number;
+      } | null;
+
+      /**
+       * The ID of the customer whose cash balance this object represents.
+       */
+      customer: string;
+
+      /**
+       * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+       */
+      livemode: boolean;
+
+      settings: CashBalance.Settings;
+    }
+
+    namespace CashBalance {
+      interface Settings {
+        /**
+         * The configuration for how funds that land in the customer cash balance are reconciled.
+         */
+        reconciliation_mode: Settings.ReconciliationMode;
+      }
+
+      namespace Settings {
+        type ReconciliationMode = 'automatic' | 'manual';
+      }
+    }
+
+    interface CashBalanceRetrieveParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
+    interface CashBalanceUpdateParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      settings?: CashBalanceUpdateParams.Settings;
+    }
+
+    namespace CashBalanceUpdateParams {
+      interface Settings {
+        /**
+         * Method for using the customer balance to pay outstanding
+         * `customer_balance` PaymentIntents. If set to `automatic`, all available
+         * funds will automatically be used to pay any outstanding PaymentIntent.
+         * If set to `manual`, only customer balance funds from bank transfers
+         * with a reference code matching
+         * `payment_intent.next_action.display_bank_transfer_intructions.reference_code` will
+         * automatically be used to pay the corresponding outstanding
+         * PaymentIntent.
+         */
+        reconciliation_mode?: Settings.ReconciliationMode;
+      }
+
+      namespace Settings {
+        type ReconciliationMode = 'automatic' | 'manual';
+      }
+    }
+  }
+}

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

@@ -409,6 +409,8 @@ declare module 'stripe' {
 
         card_present?: PaymentMethodDetails.CardPresent;
 
+        customer_balance?: PaymentMethodDetails.CustomerBalance;
+
         eps?: PaymentMethodDetails.Eps;
 
         fpx?: PaymentMethodDetails.Fpx;
@@ -1007,7 +1009,7 @@ declare module 'stripe' {
           iin?: string | null;
 
           /**
-           * Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support] /docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support.
+           * Whether this [PaymentIntent](https://stripe.com/docs/api/payment_intents) is eligible for incremental authorizations. Request support using [request_incremental_authorization_support](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-payment_method_options-card_present-request_incremental_authorization_support).
            */
           incremental_authorization_supported: boolean | null;
 
@@ -1102,6 +1104,8 @@ declare module 'stripe' {
           }
         }
 
+        interface CustomerBalance {}
+
         interface Eps {
           /**
            * The customer's bank. Should be one of `arzte_und_apotheker_bank`, `austrian_anadi_bank_ag`, `bank_austria`, `bankhaus_carl_spangler`, `bankhaus_schelhammer_und_schattera_ag`, `bawag_psk_ag`, `bks_bank_ag`, `brull_kallmus_bank_ag`, `btv_vier_lander_bank`, `capital_bank_grawe_gruppe_ag`, `dolomitenbank`, `easybank_ag`, `erste_bank_und_sparkassen`, `hypo_alpeadriabank_international_ag`, `hypo_noe_lb_fur_niederosterreich_u_wien`, `hypo_oberosterreich_salzburg_steiermark`, `hypo_tirol_bank_ag`, `hypo_vorarlberg_bank_ag`, `hypo_bank_burgenland_aktiengesellschaft`, `marchfelder_bank`, `oberbank_ag`, `raiffeisen_bankengruppe_osterreich`, `schoellerbank_ag`, `sparda_bank_wien`, `volksbank_gruppe`, `volkskreditbank_ag`, or `vr_bank_braunau`.

package/types/2020-08-27/Checkout/Sessions.d.ts

@@ -339,7 +339,7 @@ declare module 'stripe' {
 
           interface TaxId {
             /**
-             * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, or `unknown`
+             * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `eu_oss_vat`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, or `unknown`
              */
             type: TaxId.Type;
 
@@ -366,6 +366,7 @@ declare module 'stripe' {
               | 'ch_vat'
               | 'cl_tin'
               | 'es_cif'
+              | 'eu_oss_vat'
               | 'eu_vat'
               | 'gb_vat'
               | 'ge_vat'
@@ -448,6 +449,8 @@ declare module 'stripe' {
         interface PaymentMethodOptions {
           acss_debit?: PaymentMethodOptions.AcssDebit;
 
+          alipay?: PaymentMethodOptions.Alipay;
+
           boleto?: PaymentMethodOptions.Boleto;
 
           konbini?: PaymentMethodOptions.Konbini;
@@ -508,6 +511,8 @@ declare module 'stripe' {
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
           }
 
+          interface Alipay {}
+
           interface Boleto {
             /**
              * The number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days to 2, the Boleto voucher will expire on Wednesday at 23:59 America/Sao_Paulo time.
@@ -979,7 +984,8 @@ declare module 'stripe' {
          * When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout
          * with [customer_details](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-customer_details).
          *
-         * Sessions that do not create Customers will instead create [Guest Customers](https://support.stripe.com/questions/guest-customer-faq) in the Dashboard.
+         * Sessions that don't create Customers instead create [Guest Customers](https://support.stripe.com/questions/guest-customer-faq)
+         * in the Dashboard. Promotion codes limited to first time customers will return invalid for these Sessions.
          *
          * Can only be set in `payment` and `setup` mode.
          */
@@ -1325,7 +1331,7 @@ declare module 'stripe' {
               name: string;
 
               /**
-               * A [tax code](https://stripe.com/docs/tax/tax-codes) ID.
+               * A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
                */
               tax_code?: string;
             }
@@ -1536,6 +1542,11 @@ declare module 'stripe' {
            */
           acss_debit?: PaymentMethodOptions.AcssDebit;
 
+          /**
+           * contains details about the Alipay payment method options.
+           */
+          alipay?: PaymentMethodOptions.Alipay;
+
           /**
            * contains details about the Boleto payment method options.
            */
@@ -1623,6 +1634,8 @@ declare module 'stripe' {
             type VerificationMethod = 'automatic' | 'instant' | 'microdeposits';
           }
 
+          interface Alipay {}
+
           interface Boleto {
             /**
              * The number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days to 2, the Boleto invoice will expire on Wednesday at 23:59 America/Sao_Paulo time.
@@ -1634,7 +1647,7 @@ declare module 'stripe' {
             /**
              * The number of calendar days (between 1 and 60) after which Konbini payment instructions will expire. For example, if a PaymentIntent is confirmed with Konbini and `expires_after_days` set to 2 on Monday JST, the instructions will expire on Wednesday 23:59:59 JST. Defaults to 3 days.
              */
-            expires_after_days?: Stripe.Emptyable<number>;
+            expires_after_days?: number;
           }
 
           interface Oxxo {
@@ -2009,7 +2022,7 @@ declare module 'stripe' {
             tax_behavior?: ShippingRateData.TaxBehavior;
 
             /**
-             * A [tax code](https://stripe.com/docs/tax/tax-codes) ID. The Shipping tax code is `txcd_92010001`.
+             * A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
              */
             tax_code?: string;
 

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

@@ -26,6 +26,11 @@ declare module 'stripe' {
        */
       balance: number;
 
+      /**
+       * The current funds being held by Stripe on behalf of the customer. These funds can be applied towards payment intents with source "cash_balance".The settings[reconciliation_mode] field describes whether these funds are applied to such payment intents manually or automatically.
+       */
+      cash_balance?: Stripe.CashBalance | null;
+
       /**
        * Time at which the object was created. Measured in seconds since the Unix epoch.
        */
@@ -277,6 +282,11 @@ declare module 'stripe' {
        */
       balance?: number;
 
+      /**
+       * Balance information and default balance settings for this customer.
+       */
+      cash_balance?: CustomerCreateParams.CashBalance;
+
       coupon?: string;
 
       /**
@@ -365,6 +375,34 @@ declare module 'stripe' {
     }
 
     namespace CustomerCreateParams {
+      interface CashBalance {
+        /**
+         * Settings controlling the behavior of the customer's cash balance,
+         * such as reconciliation of funds received.
+         */
+        settings?: CashBalance.Settings;
+      }
+
+      namespace CashBalance {
+        interface Settings {
+          /**
+           * Method for using the customer balance to pay outstanding
+           * `customer_balance` PaymentIntents. If set to `automatic`, all available
+           * funds will automatically be used to pay any outstanding PaymentIntent.
+           * If set to `manual`, only customer balance funds from bank transfers
+           * with a reference code matching
+           * `payment_intent.next_action.display_bank_transfer_intructions.reference_code` will
+           * automatically be used to pay the corresponding outstanding
+           * PaymentIntent.
+           */
+          reconciliation_mode?: Settings.ReconciliationMode;
+        }
+
+        namespace Settings {
+          type ReconciliationMode = 'automatic' | 'manual';
+        }
+      }
+
       interface InvoiceSettings {
         /**
          * Default custom fields to be displayed on invoices for this customer. When updating, pass an empty string to remove previously-defined fields.
@@ -430,7 +468,7 @@ declare module 'stripe' {
 
       interface TaxIdDatum {
         /**
-         * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
+         * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `bg_uic`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
          */
         type: TaxIdDatum.Type;
 
@@ -457,6 +495,7 @@ declare module 'stripe' {
           | 'ch_vat'
           | 'cl_tin'
           | 'es_cif'
+          | 'eu_oss_vat'
           | 'eu_vat'
           | 'gb_vat'
           | 'ge_vat'
@@ -508,6 +547,11 @@ declare module 'stripe' {
        */
       balance?: number;
 
+      /**
+       * Balance information and default balance settings for this customer.
+       */
+      cash_balance?: CustomerUpdateParams.CashBalance;
+
       coupon?: string;
 
       /**
@@ -598,6 +642,34 @@ declare module 'stripe' {
     }
 
     namespace CustomerUpdateParams {
+      interface CashBalance {
+        /**
+         * Settings controlling the behavior of the customer's cash balance,
+         * such as reconciliation of funds received.
+         */
+        settings?: CashBalance.Settings;
+      }
+
+      namespace CashBalance {
+        interface Settings {
+          /**
+           * Method for using the customer balance to pay outstanding
+           * `customer_balance` PaymentIntents. If set to `automatic`, all available
+           * funds will automatically be used to pay any outstanding PaymentIntent.
+           * If set to `manual`, only customer balance funds from bank transfers
+           * with a reference code matching
+           * `payment_intent.next_action.display_bank_transfer_intructions.reference_code` will
+           * automatically be used to pay the corresponding outstanding
+           * PaymentIntent.
+           */
+          reconciliation_mode?: Settings.ReconciliationMode;
+        }
+
+        namespace Settings {
+          type ReconciliationMode = 'automatic' | 'manual';
+        }
+      }
+
       interface InvoiceSettings {
         /**
          * Default custom fields to be displayed on invoices for this customer. When updating, pass an empty string to remove previously-defined fields.
@@ -683,6 +755,44 @@ declare module 'stripe' {
 
     interface CustomerDeleteParams {}
 
+    interface CustomerCreateFundingInstructionsParams {
+      /**
+       * Additional parameters for `bank_transfer` funding types
+       */
+      bank_transfer: CustomerCreateFundingInstructionsParams.BankTransfer;
+
+      /**
+       * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+       */
+      currency: string;
+
+      /**
+       * The `funding_type` to get the instructions for.
+       */
+      funding_type: 'bank_transfer';
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
+    namespace CustomerCreateFundingInstructionsParams {
+      interface BankTransfer {
+        /**
+         * List of address types that should be returned in the financial_addresses response. If not specified, all valid types will be returned.
+         *
+         * Permitted values include: `zengin`.
+         */
+        requested_address_types?: Array<'zengin'>;
+
+        /**
+         * The type of the `bank_transfer`
+         */
+        type: 'jp_bank_transfer';
+      }
+    }
+
     interface CustomerDeleteDiscountParams {}
 
     interface CustomerListPaymentMethodsParams extends PaginationParams {
@@ -708,6 +818,7 @@ declare module 'stripe' {
         | 'boleto'
         | 'card'
         | 'card_present'
+        | 'customer_balance'
         | 'eps'
         | 'fpx'
         | 'giropay'
@@ -804,6 +915,17 @@ declare module 'stripe' {
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.DeletedCustomer>>;
 
+      /**
+       * Retrieve funding instructions for a customer cash balance. If funding instructions do not yet exist for the customer, new
+       * funding instructions will be created. If funding instructions have already been created for a given customer, the same
+       * funding instructions will be retrieved. In other words, we will return the same funding instructions each time.
+       */
+      createFundingInstructions(
+        id: string,
+        params: CustomerCreateFundingInstructionsParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.FundingInstructions>>;
+
       /**
        * Removes the currently applied discount on a customer.
        */
@@ -837,6 +959,28 @@ declare module 'stripe' {
         options?: RequestOptions
       ): ApiSearchResultPromise<Stripe.Customer>;
 
+      /**
+       * Retrieves a customer's cash balance.
+       */
+      retrieveCashBalance(
+        id: string,
+        params?: CashBalanceRetrieveParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.CashBalance>>;
+      retrieveCashBalance(
+        id: string,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.CashBalance>>;
+
+      /**
+       * Updates a customer's cash balance.
+       */
+      updateCashBalance(
+        id: string,
+        params?: CashBalanceUpdateParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.CashBalance>>;
+
       /**
        * Creates an immutable transaction that updates the customer's credit [balance](https://stripe.com/docs/billing/customer/balance).
        */