stripe 17.3.0-beta.1 → 17.4.0-beta.1

package/types/Checkout/Sessions.d.ts

@@ -1097,20 +1097,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;
@@ -1121,6 +1129,8 @@ declare module 'stripe' {
 
           revolut_pay?: PaymentMethodOptions.RevolutPay;
 
+          samsung_pay?: PaymentMethodOptions.SamsungPay;
+
           sepa_debit?: PaymentMethodOptions.SepaDebit;
 
           sofort?: PaymentMethodOptions.Sofort;
@@ -1510,6 +1520,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.
@@ -1545,6 +1577,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.
@@ -1588,6 +1642,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.
@@ -1619,6 +1680,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.
@@ -1776,6 +1844,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

@@ -1075,6 +1075,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.
            */
@@ -1085,6 +1090,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.
            */
@@ -1100,6 +1110,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.
            */
@@ -1110,6 +1125,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.
            */
@@ -1135,6 +1155,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.
            */
@@ -1556,6 +1581,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.
@@ -1587,6 +1629,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.
@@ -1630,6 +1689,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.
@@ -1666,6 +1742,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.
@@ -1861,6 +1939,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.

package/types/ConfirmationTokens.d.ts

@@ -190,6 +190,8 @@ declare module 'stripe' {
 
         grabpay?: PaymentMethodPreview.Grabpay;
 
+        id_bank_transfer?: PaymentMethodPreview.IdBankTransfer;
+
         ideal?: PaymentMethodPreview.Ideal;
 
         interac_present?: PaymentMethodPreview.InteracPresent;
@@ -1054,6 +1056,20 @@ declare module 'stripe' {
 
         interface Grabpay {}
 
+        interface IdBankTransfer {
+          bank: IdBankTransfer.Bank | null;
+
+          bank_code: string | null;
+
+          bank_name: string | null;
+
+          display_name: string | null;
+        }
+
+        namespace IdBankTransfer {
+          type Bank = 'bca' | 'bni' | 'bri' | 'cimb' | 'permata';
+        }
+
         interface Ideal {
           /**
            * The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
@@ -1495,6 +1511,7 @@ declare module 'stripe' {
           | 'giropay'
           | 'gopay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'interac_present'
           | 'kakao_pay'

package/types/CustomersResource.d.ts

@@ -834,6 +834,7 @@ declare module 'stripe' {
         | 'giropay'
         | 'gopay'
         | 'grabpay'
+        | 'id_bank_transfer'
         | 'ideal'
         | 'kakao_pay'
         | 'klarna'

package/types/Disputes.d.ts

@@ -48,7 +48,7 @@ declare module 'stripe' {
       /**
        * List of eligibility types that are included in `enhanced_evidence`.
        */
-      enhanced_eligibility_types?: Array<'visa_compelling_evidence_3'>;
+      enhanced_eligibility_types: Array<'visa_compelling_evidence_3'>;
 
       evidence: Dispute.Evidence;
 
@@ -159,7 +159,7 @@ declare module 'stripe' {
          */
         duplicate_charge_id: string | null;
 
-        enhanced_evidence?: Evidence.EnhancedEvidence;
+        enhanced_evidence: Evidence.EnhancedEvidence;
 
         /**
          * A description of the product or service that was sold.
@@ -350,7 +350,7 @@ declare module 'stripe' {
          */
         due_by: number | null;
 
-        enhanced_eligibility?: EvidenceDetails.EnhancedEligibility;
+        enhanced_eligibility: EvidenceDetails.EnhancedEligibility;
 
         /**
          * Whether evidence has been staged for this dispute.

package/types/EventTypes.d.ts

@@ -146,6 +146,7 @@ declare module 'stripe' {
       | IssuingTokenCreatedEvent
       | IssuingTokenUpdatedEvent
       | IssuingTransactionCreatedEvent
+      | IssuingTransactionPurchaseDetailsReceiptUpdatedEvent
       | IssuingTransactionUpdatedEvent
       | MandateUpdatedEvent
       | PaymentIntentAmountCapturableUpdatedEvent
@@ -2571,6 +2572,23 @@ declare module 'stripe' {
       }
     }
 
+    /**
+     * Occurs whenever an issuing transaction is updated with receipt data.
+     */
+    interface IssuingTransactionPurchaseDetailsReceiptUpdatedEvent
+      extends EventBase {
+      type: 'issuing_transaction.purchase_details_receipt_updated';
+      data: IssuingTransactionPurchaseDetailsReceiptUpdatedEvent.Data;
+    }
+
+    namespace IssuingTransactionPurchaseDetailsReceiptUpdatedEvent {
+      interface Data extends Stripe.Event.Data {
+        object: Stripe.Issuing.Transaction;
+
+        previous_attributes?: Partial<Stripe.Issuing.Transaction>;
+      }
+    }
+
     /**
      * Occurs whenever an issuing transaction is updated.
      */

package/types/Events.d.ts

@@ -230,6 +230,7 @@ declare module 'stripe' {
         | 'issuing_token.created'
         | 'issuing_token.updated'
         | 'issuing_transaction.created'
+        | 'issuing_transaction.purchase_details_receipt_updated'
         | 'issuing_transaction.updated'
         | 'mandate.updated'
         | 'payment_intent.amount_capturable_updated'

package/types/Invoices.d.ts

@@ -994,7 +994,6 @@ declare module 'stripe' {
           | 'payment_method_unexpected_state'
           | 'payment_method_unsupported_type'
           | 'payout_reconciliation_not_ready'
-          | 'payout_statement_descriptor_profanity'
           | 'payouts_limit_exceeded'
           | 'payouts_not_allowed'
           | 'platform_account_required'
@@ -1090,6 +1089,11 @@ declare module 'stripe' {
            */
           customer_balance: PaymentMethodOptions.CustomerBalance | null;
 
+          /**
+           * If paying by `id_bank_transfer`, this sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice's PaymentIntent.
+           */
+          id_bank_transfer?: PaymentMethodOptions.IdBankTransfer | null;
+
           /**
            * If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1195,6 +1199,8 @@ declare module 'stripe' {
             }
           }
 
+          interface IdBankTransfer {}
+
           interface Konbini {}
 
           interface SepaDebit {}
@@ -1273,6 +1279,7 @@ declare module 'stripe' {
           | 'fpx'
           | 'giropay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'

package/types/InvoicesResource.d.ts

@@ -28,6 +28,11 @@ declare module 'stripe' {
        */
       automatic_tax?: InvoiceCreateParams.AutomaticTax;
 
+      /**
+       * The time when this invoice should be scheduled to finalize. The invoice will be finalized at this time if it is still in draft state.
+       */
+      automatically_finalizes_at?: number;
+
       /**
        * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this invoice using the default source attached to the customer. When sending an invoice, Stripe will email this invoice to the customer with payment instructions. Defaults to `charge_automatically`.
        */
@@ -368,6 +373,13 @@ declare module 'stripe' {
             PaymentMethodOptions.CustomerBalance
           >;
 
+          /**
+           * If paying by `id_bank_transfer`, this sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice's PaymentIntent.
+           */
+          id_bank_transfer?: Stripe.Emptyable<
+            PaymentMethodOptions.IdBankTransfer
+          >;
+
           /**
            * If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent.
            */
@@ -511,6 +523,8 @@ declare module 'stripe' {
             }
           }
 
+          interface IdBankTransfer {}
+
           interface Konbini {}
 
           interface SepaDebit {}
@@ -595,6 +609,7 @@ declare module 'stripe' {
           | 'fpx'
           | 'giropay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'
@@ -859,6 +874,11 @@ declare module 'stripe' {
        */
       automatic_tax?: InvoiceUpdateParams.AutomaticTax;
 
+      /**
+       * The time when this invoice should be scheduled to finalize. The invoice will be finalized at this time if it is still in draft state. To turn off automatic finalization, set `auto_advance` to false.
+       */
+      automatically_finalizes_at?: number;
+
       /**
        * Either `charge_automatically` or `send_invoice`. This field can be updated only on `draft` invoices.
        */
@@ -1162,6 +1182,13 @@ declare module 'stripe' {
             PaymentMethodOptions.CustomerBalance
           >;
 
+          /**
+           * If paying by `id_bank_transfer`, this sub-hash contains details about the Indonesia bank transfer payment method options to pass to the invoice's PaymentIntent.
+           */
+          id_bank_transfer?: Stripe.Emptyable<
+            PaymentMethodOptions.IdBankTransfer
+          >;
+
           /**
            * If paying by `konbini`, this sub-hash contains details about the Konbini payment method options to pass to the invoice's PaymentIntent.
            */
@@ -1305,6 +1332,8 @@ declare module 'stripe' {
             }
           }
 
+          interface IdBankTransfer {}
+
           interface Konbini {}
 
           interface SepaDebit {}
@@ -1389,6 +1418,7 @@ declare module 'stripe' {
           | 'fpx'
           | 'giropay'
           | 'grabpay'
+          | 'id_bank_transfer'
           | 'ideal'
           | 'jp_credit_transfer'
           | 'kakao_pay'

package/types/PaymentIntents.d.ts

@@ -537,7 +537,6 @@ declare module 'stripe' {
           | 'payment_method_unexpected_state'
           | 'payment_method_unsupported_type'
           | 'payout_reconciliation_not_ready'
-          | 'payout_statement_descriptor_profanity'
           | 'payouts_limit_exceeded'
           | 'payouts_not_allowed'
           | 'platform_account_required'
@@ -1636,6 +1635,8 @@ declare module 'stripe' {
 
         grabpay?: PaymentMethodOptions.Grabpay;
 
+        id_bank_transfer?: PaymentMethodOptions.IdBankTransfer;
+
         ideal?: PaymentMethodOptions.Ideal;
 
         interac_present?: PaymentMethodOptions.InteracPresent;
@@ -2388,6 +2389,29 @@ declare module 'stripe' {
           setup_future_usage?: 'none';
         }
 
+        interface IdBankTransfer {
+          /**
+           * The UNIX timestamp until which the virtual bank account is valid. Permitted range is from now till 2678400 seconds (31 days) from now.
+           */
+          expires_after?: number | null;
+
+          /**
+           * The UNIX timestamp until which the virtual bank account is valid. Permitted range is from now until 30 days from now. If unset, it defaults to 1 days from now.
+           */
+          expires_at: number | null;
+
+          /**
+           * 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?: 'none';
+        }
+
         interface Ideal {
           /**
            * Indicates that you intend to make future payments with this PaymentIntent's payment method.