stripe 17.2.1 → 17.3.0

package/types/BillingPortal/ConfigurationsResource.d.ts

@@ -5,14 +5,14 @@ declare module 'stripe' {
     namespace BillingPortal {
       interface ConfigurationCreateParams {
         /**
-         * The business information shown to customers in the portal.
+         * Information about the features available in the portal.
          */
-        business_profile: ConfigurationCreateParams.BusinessProfile;
+        features: ConfigurationCreateParams.Features;
 
         /**
-         * Information about the features available in the portal.
+         * The business information shown to customers in the portal.
          */
-        features: ConfigurationCreateParams.Features;
+        business_profile?: ConfigurationCreateParams.BusinessProfile;
 
         /**
          * The default URL to redirect customers to when they click on the portal's link to return to your website. This can be [overriden](https://stripe.com/docs/api/customer_portal/sessions/create#create_portal_session-return_url) when creating the session.
@@ -196,6 +196,11 @@ declare module 'stripe' {
              * Determines how to handle prorations resulting from subscription updates. Valid values are `none`, `create_prorations`, and `always_invoice`.
              */
             proration_behavior?: SubscriptionUpdate.ProrationBehavior;
+
+            /**
+             * Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
+             */
+            schedule_at_period_end?: SubscriptionUpdate.ScheduleAtPeriodEnd;
           }
 
           namespace SubscriptionUpdate {
@@ -217,6 +222,26 @@ declare module 'stripe' {
               | 'always_invoice'
               | 'create_prorations'
               | 'none';
+
+            interface ScheduleAtPeriodEnd {
+              /**
+               * List of conditions. When any condition is true, the update will be scheduled at the end of the current period.
+               */
+              conditions?: Array<ScheduleAtPeriodEnd.Condition>;
+            }
+
+            namespace ScheduleAtPeriodEnd {
+              interface Condition {
+                /**
+                 * The type of condition.
+                 */
+                type: Condition.Type;
+              }
+
+              namespace Condition {
+                type Type = 'decreasing_item_amount' | 'shortening_interval';
+              }
+            }
           }
         }
 
@@ -433,6 +458,11 @@ declare module 'stripe' {
              * Determines how to handle prorations resulting from subscription updates. Valid values are `none`, `create_prorations`, and `always_invoice`.
              */
             proration_behavior?: SubscriptionUpdate.ProrationBehavior;
+
+            /**
+             * Setting to control when an update should be scheduled at the end of the period instead of applying immediately.
+             */
+            schedule_at_period_end?: SubscriptionUpdate.ScheduleAtPeriodEnd;
           }
 
           namespace SubscriptionUpdate {
@@ -454,6 +484,28 @@ declare module 'stripe' {
               | 'always_invoice'
               | 'create_prorations'
               | 'none';
+
+            interface ScheduleAtPeriodEnd {
+              /**
+               * List of conditions. When any condition is true, the update will be scheduled at the end of the current period.
+               */
+              conditions?: Stripe.Emptyable<
+                Array<ScheduleAtPeriodEnd.Condition>
+              >;
+            }
+
+            namespace ScheduleAtPeriodEnd {
+              interface Condition {
+                /**
+                 * The type of condition.
+                 */
+                type: Condition.Type;
+              }
+
+              namespace Condition {
+                type Type = 'decreasing_item_amount' | 'shortening_interval';
+              }
+            }
           }
         }
 

package/types/Charges.d.ts

@@ -380,6 +380,8 @@ declare module 'stripe' {
 
         alipay?: PaymentMethodDetails.Alipay;
 
+        alma?: PaymentMethodDetails.Alma;
+
         amazon_pay?: PaymentMethodDetails.AmazonPay;
 
         au_becs_debit?: PaymentMethodDetails.AuBecsDebit;
@@ -412,20 +414,28 @@ declare module 'stripe' {
 
         interac_present?: PaymentMethodDetails.InteracPresent;
 
+        kakao_pay?: PaymentMethodDetails.KakaoPay;
+
         klarna?: PaymentMethodDetails.Klarna;
 
         konbini?: PaymentMethodDetails.Konbini;
 
+        kr_card?: PaymentMethodDetails.KrCard;
+
         link?: PaymentMethodDetails.Link;
 
         mobilepay?: PaymentMethodDetails.Mobilepay;
 
         multibanco?: PaymentMethodDetails.Multibanco;
 
+        naver_pay?: PaymentMethodDetails.NaverPay;
+
         oxxo?: PaymentMethodDetails.Oxxo;
 
         p24?: PaymentMethodDetails.P24;
 
+        payco?: PaymentMethodDetails.Payco;
+
         paynow?: PaymentMethodDetails.Paynow;
 
         paypal?: PaymentMethodDetails.Paypal;
@@ -436,6 +446,8 @@ declare module 'stripe' {
 
         revolut_pay?: PaymentMethodDetails.RevolutPay;
 
+        samsung_pay?: PaymentMethodDetails.SamsungPay;
+
         sepa_credit_transfer?: PaymentMethodDetails.SepaCreditTransfer;
 
         sepa_debit?: PaymentMethodDetails.SepaDebit;
@@ -591,6 +603,8 @@ declare module 'stripe' {
           transaction_id: string | null;
         }
 
+        interface Alma {}
+
         interface AmazonPay {}
 
         interface AuBecsDebit {
@@ -1656,6 +1670,13 @@ declare module 'stripe' {
           }
         }
 
+        interface KakaoPay {
+          /**
+           * A unique identifier for the buyer as determined by the local payment processor.
+           */
+          buyer_id: string | null;
+        }
+
         interface Klarna {
           /**
            * The payer details for this transaction.
@@ -1713,6 +1734,49 @@ declare module 'stripe' {
           }
         }
 
+        interface KrCard {
+          /**
+           * The local credit or debit card brand.
+           */
+          brand: KrCard.Brand | null;
+
+          /**
+           * A unique identifier for the buyer as determined by the local payment processor.
+           */
+          buyer_id: string | null;
+
+          /**
+           * The last four digits of the card. This may not be present for American Express cards.
+           */
+          last4: string | null;
+        }
+
+        namespace KrCard {
+          type Brand =
+            | 'bc'
+            | 'citi'
+            | 'hana'
+            | 'hyundai'
+            | 'jeju'
+            | 'jeonbuk'
+            | 'kakaobank'
+            | 'kbank'
+            | 'kdbbank'
+            | 'kookmin'
+            | 'kwangju'
+            | 'lotte'
+            | 'mg'
+            | 'nh'
+            | 'post'
+            | 'samsung'
+            | 'savingsbank'
+            | 'shinhan'
+            | 'shinhyup'
+            | 'suhyup'
+            | 'tossbank'
+            | 'woori';
+        }
+
         interface Link {
           /**
            * Two-letter ISO code representing the funding source country beneath the Link payment.
@@ -1769,6 +1833,13 @@ declare module 'stripe' {
           reference: string | null;
         }
 
+        interface NaverPay {
+          /**
+           * A unique identifier for the buyer as determined by the local payment processor.
+           */
+          buyer_id: string | null;
+        }
+
         interface Oxxo {
           /**
            * OXXO reference number
@@ -1825,6 +1896,13 @@ declare module 'stripe' {
             | 'volkswagen_bank';
         }
 
+        interface Payco {
+          /**
+           * A unique identifier for the buyer as determined by the local payment processor.
+           */
+          buyer_id: string | null;
+        }
+
         interface Paynow {
           /**
            * Reference number associated with this PayNow payment
@@ -1897,6 +1975,13 @@ declare module 'stripe' {
 
         interface RevolutPay {}
 
+        interface SamsungPay {
+          /**
+           * A unique identifier for the buyer as determined by the local payment processor.
+           */
+          buyer_id: string | null;
+        }
+
         interface SepaCreditTransfer {
           /**
            * Name of the bank associated with the bank account.

package/types/Checkout/Sessions.d.ts

@@ -490,7 +490,7 @@ declare module 'stripe' {
 
           interface TaxId {
             /**
-             * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `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`, `jp_trn`, `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`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, or `unknown`
+             * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `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`, `jp_trn`, `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`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, or `unknown`
              */
             type: TaxId.Type;
 
@@ -512,6 +512,7 @@ declare module 'stripe' {
               | 'bo_tin'
               | 'br_cnpj'
               | 'br_cpf'
+              | 'by_tin'
               | 'ca_bn'
               | 'ca_gst_hst'
               | 'ca_pst_bc'
@@ -547,6 +548,8 @@ declare module 'stripe' {
               | 'kr_brn'
               | 'kz_bin'
               | 'li_uid'
+              | 'ma_vat'
+              | 'md_vat'
               | 'mx_rfc'
               | 'my_frp'
               | 'my_itn'
@@ -570,10 +573,13 @@ declare module 'stripe' {
               | 'th_vat'
               | 'tr_tin'
               | 'tw_vat'
+              | 'tz_vat'
               | 'ua_vat'
               | 'unknown'
               | 'us_ein'
               | 'uy_ruc'
+              | 'uz_tin'
+              | 'uz_vat'
               | 've_rif'
               | 'vn_tin'
               | 'za_vat';
@@ -929,20 +935,28 @@ declare module 'stripe' {
 
           ideal?: PaymentMethodOptions.Ideal;
 
+          kakao_pay?: PaymentMethodOptions.KakaoPay;
+
           klarna?: PaymentMethodOptions.Klarna;
 
           konbini?: PaymentMethodOptions.Konbini;
 
+          kr_card?: PaymentMethodOptions.KrCard;
+
           link?: PaymentMethodOptions.Link;
 
           mobilepay?: PaymentMethodOptions.Mobilepay;
 
           multibanco?: PaymentMethodOptions.Multibanco;
 
+          naver_pay?: PaymentMethodOptions.NaverPay;
+
           oxxo?: PaymentMethodOptions.Oxxo;
 
           p24?: PaymentMethodOptions.P24;
 
+          payco?: PaymentMethodOptions.Payco;
+
           paynow?: PaymentMethodOptions.Paynow;
 
           paypal?: PaymentMethodOptions.Paypal;
@@ -951,6 +965,8 @@ declare module 'stripe' {
 
           revolut_pay?: PaymentMethodOptions.RevolutPay;
 
+          samsung_pay?: PaymentMethodOptions.SamsungPay;
+
           sepa_debit?: PaymentMethodOptions.SepaDebit;
 
           sofort?: PaymentMethodOptions.Sofort;
@@ -1340,6 +1356,28 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface KakaoPay {
+            /**
+             * Controls when the funds will be captured from the customer's account.
+             */
+            capture_method?: 'manual';
+
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: KakaoPay.SetupFutureUsage;
+          }
+
+          namespace KakaoPay {
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface Klarna {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1375,6 +1413,28 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface KrCard {
+            /**
+             * Controls when the funds will be captured from the customer's account.
+             */
+            capture_method?: 'manual';
+
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: KrCard.SetupFutureUsage;
+          }
+
+          namespace KrCard {
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface Link {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1418,6 +1478,13 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface NaverPay {
+            /**
+             * Controls when the funds will be captured from the customer's account.
+             */
+            capture_method?: 'manual';
+          }
+
           interface Oxxo {
             /**
              * The number of calendar days before an OXXO invoice expires. For example, if you create an OXXO invoice on Monday and you set expires_after_days to 2, the OXXO invoice will expire on Wednesday at 23:59 America/Mexico_City time.
@@ -1449,6 +1516,13 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface Payco {
+            /**
+             * Controls when the funds will be captured from the customer's account.
+             */
+            capture_method?: 'manual';
+          }
+
           interface Paynow {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1518,6 +1592,13 @@ declare module 'stripe' {
             type SetupFutureUsage = 'none' | 'off_session';
           }
 
+          interface SamsungPay {
+            /**
+             * Controls when the funds will be captured from the customer's account.
+             */
+            capture_method?: 'manual';
+          }
+
           interface SepaDebit {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.

package/types/Checkout/SessionsResource.d.ts

@@ -1068,6 +1068,11 @@ declare module 'stripe' {
            */
           ideal?: PaymentMethodOptions.Ideal;
 
+          /**
+           * contains details about the Kakao Pay payment method options.
+           */
+          kakao_pay?: PaymentMethodOptions.KakaoPay;
+
           /**
            * contains details about the Klarna payment method options.
            */
@@ -1078,6 +1083,11 @@ declare module 'stripe' {
            */
           konbini?: PaymentMethodOptions.Konbini;
 
+          /**
+           * contains details about the Korean card payment method options.
+           */
+          kr_card?: PaymentMethodOptions.KrCard;
+
           /**
            * contains details about the Link payment method options.
            */
@@ -1093,6 +1103,11 @@ declare module 'stripe' {
            */
           multibanco?: PaymentMethodOptions.Multibanco;
 
+          /**
+           * contains details about the Kakao Pay payment method options.
+           */
+          naver_pay?: PaymentMethodOptions.NaverPay;
+
           /**
            * contains details about the OXXO payment method options.
            */
@@ -1103,6 +1118,11 @@ declare module 'stripe' {
            */
           p24?: PaymentMethodOptions.P24;
 
+          /**
+           * contains details about the PAYCO payment method options.
+           */
+          payco?: PaymentMethodOptions.Payco;
+
           /**
            * contains details about the PayNow payment method options.
            */
@@ -1123,6 +1143,11 @@ declare module 'stripe' {
            */
           revolut_pay?: PaymentMethodOptions.RevolutPay;
 
+          /**
+           * contains details about the Samsung Pay payment method options.
+           */
+          samsung_pay?: PaymentMethodOptions.SamsungPay;
+
           /**
            * contains details about the Sepa Debit payment method options.
            */
@@ -1544,6 +1569,23 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface KakaoPay {
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: KakaoPay.SetupFutureUsage;
+          }
+
+          namespace KakaoPay {
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface Klarna {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1575,6 +1617,23 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface KrCard {
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: KrCard.SetupFutureUsage;
+          }
+
+          namespace KrCard {
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface Link {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1618,6 +1677,23 @@ declare module 'stripe' {
             setup_future_usage?: 'none';
           }
 
+          interface NaverPay {
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: NaverPay.SetupFutureUsage;
+          }
+
+          namespace NaverPay {
+            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.
@@ -1654,6 +1730,8 @@ declare module 'stripe' {
             tos_shown_and_accepted?: boolean;
           }
 
+          interface Payco {}
+
           interface Paynow {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1753,6 +1831,8 @@ declare module 'stripe' {
             type SetupFutureUsage = 'none' | 'off_session';
           }
 
+          interface SamsungPay {}
+
           interface SepaDebit {
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1874,6 +1954,7 @@ declare module 'stripe' {
           | 'affirm'
           | 'afterpay_clearpay'
           | 'alipay'
+          | 'alma'
           | 'amazon_pay'
           | 'au_becs_debit'
           | 'bacs_debit'
@@ -1888,18 +1969,23 @@ declare module 'stripe' {
           | 'giropay'
           | 'grabpay'
           | 'ideal'
+          | 'kakao_pay'
           | 'klarna'
           | 'konbini'
+          | 'kr_card'
           | 'link'
           | 'mobilepay'
           | 'multibanco'
+          | 'naver_pay'
           | 'oxxo'
           | 'p24'
+          | 'payco'
           | 'paynow'
           | 'paypal'
           | 'pix'
           | 'promptpay'
           | 'revolut_pay'
+          | 'samsung_pay'
           | 'sepa_debit'
           | 'sofort'
           | 'swish'