stripe 22.4.0-alpha.2 → 22.4.0-alpha.3

package/cjs/resources/Issuing/Authorizations.d.ts

@@ -143,6 +143,10 @@ export interface Authorization {
      * The current status of the authorization in its lifecycle.
      */
     status: Authorization.Status;
+    /**
+     * Details about the cardholder verification outcome at the terminal.
+     */
+    terminal_data?: Authorization.TerminalData | null;
     /**
      * [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this authorization. If a network token was not used for this authorization, this field will be null.
      */
@@ -330,10 +334,18 @@ export declare namespace Authorization {
         url: string | null;
     }
     interface NetworkData {
+        /**
+         * Country code of the acquirer assigned by the card network.
+         */
+        acquiring_institution_country?: string | null;
         /**
          * Identifier assigned to the acquirer by the card network. Sometimes this value is not provided by the network; in this case, the value will be `null`.
          */
         acquiring_institution_id: string | null;
+        /**
+         * Identifier assigned by the acquirer to track all messages related to this transaction.
+         */
+        retrieval_reference_number?: string | null;
         /**
          * The System Trace Audit Number (STAN) is a 6-digit identifier assigned by the acquirer. Prefer `network_data.transaction_id` if present, unless you have special requirements.
          */
@@ -412,6 +424,10 @@ export declare namespace Authorization {
          * The currency that was collected by the merchant and presented to the cardholder for the authorization. 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).
          */
         merchant_currency: string;
+        /**
+         * Details about the authorization request, such as identifiers, set by the card network.
+         */
+        network_data?: RequestHistory.NetworkData | null;
         /**
          * The card network's estimate of the likelihood that an authorization is fraudulent. Takes on values between 1 and 99.
          */
@@ -430,6 +446,12 @@ export declare namespace Authorization {
         requested_at: number | null;
     }
     type Status = 'closed' | 'expired' | 'pending' | 'reversed';
+    interface TerminalData {
+        /**
+         * The method used to confirm the cardholder's identity.
+         */
+        cardholder_verification_result: TerminalData.CardholderVerificationResult | null;
+    }
     interface TokenDetails {
         /**
          * The card associated with this token.
@@ -830,7 +852,32 @@ export declare namespace Authorization {
              */
             cashback_amount: number | null;
         }
+        interface NetworkData {
+            /**
+             * Mastercard identifier for each authorization request.
+             */
+            trace_id: NetworkData.TraceId | null;
+        }
         type Reason = 'account_disabled' | 'card_active' | 'card_canceled' | 'card_expired' | 'card_inactive' | 'cardholder_blocked' | 'cardholder_inactive' | 'cardholder_verification_required' | 'insecure_authorization_method' | 'insufficient_funds' | 'network_fallback' | 'not_allowed' | 'pin_blocked' | 'spending_controls' | 'suspected_fraud' | 'verification_failed' | 'webhook_approved' | 'webhook_declined' | 'webhook_error' | 'webhook_timeout';
+        namespace NetworkData {
+            interface TraceId {
+                /**
+                 * The unique reference number within the specified financial network on the specified network date.
+                 */
+                banknet_reference_number: string | null;
+                /**
+                 * The identifier of the program or service.
+                 */
+                financial_network_code: string | null;
+                /**
+                 * The card network's record date for this authorization.
+                 */
+                network_date: string | null;
+            }
+        }
+    }
+    namespace TerminalData {
+        type CardholderVerificationResult = 'failed' | 'none' | 'pin' | 'pin_and_signature' | 'signature' | 'unknown';
     }
     namespace TokenDetails {
         interface NetworkData {

package/cjs/resources/Issuing/Transactions.d.ts

@@ -108,6 +108,10 @@ export interface Transaction {
      * The ID of the [settlement](https://docs.stripe.com/api/issuing/settlements) to which this transaction belongs.
      */
     settlement?: string | Settlement | null;
+    /**
+     * Details about the transaction for settlement reconciliation.
+     */
+    settlement_details?: Transaction.SettlementDetails | null;
     /**
      * [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
      */
@@ -209,6 +213,14 @@ export declare namespace Transaction {
          * The network-provided acquirer reference number for this transaction, if available. Use this value for downstream operational workflows such as filing disputes with the card network.
          */
         acquirer_reference_number?: string | null;
+        /**
+         * The two-letter country code of the acquirer ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+         */
+        acquiring_institution_country?: string | null;
+        /**
+         * Identifier assigned to the acquirer by the card network. Sometimes this value is not provided by the network; in this case, the value will be null.
+         */
+        acquiring_institution_id?: string | null;
         /**
          * A code created by Stripe which is shared with the merchant to validate the authorization. This field will be populated if the authorization message was approved. The code typically starts with the letter "S", followed by a six-digit number. For example, "S498162". Please note that the code is not guaranteed to be unique across authorizations.
          */
@@ -217,6 +229,15 @@ export declare namespace Transaction {
          * The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
          */
         processing_date: string | null;
+        /**
+         * Identifier assigned by the acquirer to track all messages related to this transaction.
+         */
+        retrieval_reference_number?: string | null;
+        /**
+         * The card network over which Stripe received the transaction. This field may differ from the associated card's primary network.
+         */
+        routed_network?: NetworkData.RoutedNetwork | null;
+        trace_id?: NetworkData.TraceId;
         /**
          * Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
          */
@@ -254,6 +275,20 @@ export declare namespace Transaction {
          */
         status: Redaction.Status;
     }
+    interface SettlementDetails {
+        /**
+         * `merchant_amount` in the settlement currency.
+         */
+        amount: number | null;
+        /**
+         * Settlement currency.
+         */
+        currency: string | null;
+        /**
+         * Exchange rate used by the network to convert the `merchant_amount` to `settlement_details.amount`. The `merchant_amount` multiplied with this rate will equal to the `settlement_details.amount`.
+         */
+        exchange_rate: number | null;
+    }
     interface Treasury {
         /**
          * The Treasury [ReceivedCredit](https://docs.stripe.com/api/treasury/received_credits) representing this Issuing transaction if it is a refund
@@ -388,6 +423,23 @@ export declare namespace Transaction {
             }
         }
     }
+    namespace NetworkData {
+        type RoutedNetwork = 'cirrus' | 'interlink' | 'maestro' | 'mastercard' | 'other' | 'plus' | 'visa';
+        interface TraceId {
+            /**
+             * The unique reference number within the specified financial network on the specified network date.
+             */
+            banknet_reference_number: string | null;
+            /**
+             * The identifier of the program or service.
+             */
+            financial_network_code: string | null;
+            /**
+             * The card network's record date for this transaction.
+             */
+            network_date: string | null;
+        }
+    }
     namespace PurchaseDetails {
         interface Fleet {
             /**

package/cjs/resources/PaymentAttemptRecords.d.ts

@@ -884,7 +884,7 @@ export declare namespace PaymentAttemptRecord {
              */
             account_holder_type: Fpx.AccountHolderType | null;
             /**
-             * The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
+             * The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bnp_paribas`, `bank_rakyat`, `bsn`, `cimb`, `citibank`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `mbsb_bank`, `pb_enterprise`, or `bank_of_china`.
              */
             bank: Fpx.Bank;
             /**
@@ -1597,7 +1597,7 @@ export declare namespace PaymentAttemptRecord {
             namespace Funding {
                 interface Card {
                     /**
-                     * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
+                     * Card brand. Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
                      */
                     brand: string | null;
                     /**
@@ -1839,7 +1839,7 @@ export declare namespace PaymentAttemptRecord {
         }
         namespace Fpx {
             type AccountHolderType = 'company' | 'individual';
-            type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bsn' | 'cimb' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
+            type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bnp_paribas' | 'bsn' | 'cimb' | 'citibank' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'mbsb_bank' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
         }
         namespace GiftCard {
             interface Balance {

package/cjs/resources/PaymentIntents.d.ts

@@ -9,6 +9,7 @@ import { PaymentRecord } from './PaymentRecords.js';
 import { Review } from './Reviews.js';
 import { CustomerSource, DeletedCustomerSource } from './CustomerSources.js';
 import { Profile } from './Profiles.js';
+import { GiftCardOperation } from './GiftCardOperations.js';
 import { SetupIntent } from './SetupIntents.js';
 import { Emptyable, MetadataParam, AddressParam, Address, ShippingAddressParam, PaginationParams, RangeQueryParam, Metadata } from '../shared.js';
 import { RequestOptions, ApiListPromise, Response, ApiList, ApiSearchResultPromise } from '../lib.js';
@@ -501,6 +502,11 @@ export declare namespace PaymentIntent {
          * A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
          */
         doc_url?: string;
+        /**
+         * A GiftCardOperation represents an operation performed on a third-party gift card,
+         * such as activation, reload, cashout, balance check, or void.
+         */
+        gift_card_operation?: GiftCardOperation;
         /**
          * A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
          */
@@ -3533,6 +3539,16 @@ export declare namespace PaymentIntent {
              * 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://docs.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://docs.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://docs.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://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: 'none';
         }
         interface Paynow {
             /**
@@ -3583,6 +3599,16 @@ export declare namespace PaymentIntent {
             subsellers?: Array<string>;
         }
         interface Paypay {
+            /**
+             * 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://docs.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://docs.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://docs.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://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: Paypay.SetupFutureUsage;
         }
         interface Payto {
             mandate_options?: Payto.MandateOptions;
@@ -3669,6 +3695,16 @@ export declare namespace PaymentIntent {
              * 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://docs.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://docs.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://docs.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://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: 'none';
         }
         interface Satispay {
             /**
@@ -4251,6 +4287,9 @@ export declare namespace PaymentIntent {
                 }
             }
         }
+        namespace Paypay {
+            type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
+        }
         namespace Payto {
             interface MandateOptions {
                 /**
@@ -4654,7 +4693,7 @@ export declare namespace PaymentIntentCreateParams {
          */
         enabled?: boolean;
     }
-    type AllowedPaymentMethodType = 'acss_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'alma' | 'amazon_pay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'billie' | 'bizum' | 'blik' | 'boleto' | 'card' | 'cashapp' | 'crypto' | 'customer_balance' | 'eps' | 'fpx' | 'gift_card' | 'giropay' | 'gopay' | 'grabpay' | 'id_bank_transfer' | 'ideal' | 'kakao_pay' | 'klarna' | 'konbini' | 'kr_card' | 'link' | 'mb_way' | 'mobilepay' | 'multibanco' | 'naver_pay' | 'nz_bank_account' | 'oxxo' | 'p24' | 'pay_by_bank' | 'payco' | 'paynow' | 'paypal' | 'paypay' | 'payto' | 'pix' | 'promptpay' | 'qris' | 'rechnung' | 'revolut_pay' | 'samsung_pay' | 'satispay' | 'scalapay' | 'sepa_debit' | 'shopeepay' | 'sofort' | 'stripe_balance' | 'sunbit' | 'swish' | 'tamara' | 'twint' | 'upi' | 'us_bank_account' | 'wechat_pay' | 'zip';
+    type AllowedPaymentMethodType = 'acss_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'alma' | 'amazon_pay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'billie' | 'bizum' | 'blik' | 'boku_promptpay' | 'boleto' | 'capchase_pay' | 'card' | 'cashapp' | 'check_scan' | 'click_to_pay' | 'crypto' | 'customer_balance' | 'demo_pay' | 'duitnow' | 'dummy_auth_push' | 'dummy_passthrough_card' | 'edenred' | 'eps' | 'fpx' | 'gcash' | 'getbalance' | 'gift_card' | 'giropay' | 'gopay' | 'grabpay' | 'id_bank_transfer' | 'ideal' | 'kakao_pay' | 'klarna' | 'knet' | 'konbini' | 'kr_card' | 'kr_market' | 'kriya' | 'link' | 'mb_way' | 'mobilepay' | 'momo' | 'mondu' | 'multibanco' | 'naver_pay' | 'netbanking' | 'ng_bank' | 'ng_bank_transfer' | 'ng_card' | 'ng_market' | 'ng_ussd' | 'ng_wallet' | 'nz_bank_account' | 'octopus' | 'oxxo' | 'p24' | 'paper_check' | 'pay_by_bank' | 'payco' | 'paynow' | 'paypal' | 'paypay' | 'payto' | 'pix' | 'promptpay' | 'qris' | 'rechnung' | 'revolut_pay' | 'samsung_pay' | 'satispay' | 'scalapay' | 'sepa_debit' | 'sequra' | 'shop_pay' | 'shopeepay' | 'sofort' | 'south_korea_market' | 'stripe_balance' | 'sunbit' | 'swish' | 'tamara' | 'test_pay' | 'truemoney' | 'twint' | 'upi' | 'us_bank_account' | 'us_cash_voucher' | 'vipps' | 'wechat_pay' | 'wero' | 'zip';
     interface AmountDetails {
         /**
          * The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0.
@@ -8515,6 +8554,16 @@ export declare namespace PaymentIntentCreateParams {
              * If `capture_method` is already set on the PaymentIntent, providing an empty value for this parameter unsets the stored value for this payment method type.
              */
             capture_method?: Emptyable<'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://docs.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://docs.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://docs.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://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: Emptyable<Paypay.SetupFutureUsage>;
         }
         interface Payto {
             /**
@@ -10242,6 +10291,9 @@ export declare namespace PaymentIntentCreateParams {
                 }
             }
         }
+        namespace Paypay {
+            type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
+        }
         namespace Payto {
             interface MandateOptions {
                 /**
@@ -10611,7 +10663,7 @@ export declare namespace PaymentIntentUpdateParams {
          */
         enabled?: boolean;
     }
-    type AllowedPaymentMethodType = 'acss_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'alma' | 'amazon_pay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'billie' | 'bizum' | 'blik' | 'boleto' | 'card' | 'cashapp' | 'crypto' | 'customer_balance' | 'eps' | 'fpx' | 'gift_card' | 'giropay' | 'gopay' | 'grabpay' | 'id_bank_transfer' | 'ideal' | 'kakao_pay' | 'klarna' | 'konbini' | 'kr_card' | 'link' | 'mb_way' | 'mobilepay' | 'multibanco' | 'naver_pay' | 'nz_bank_account' | 'oxxo' | 'p24' | 'pay_by_bank' | 'payco' | 'paynow' | 'paypal' | 'paypay' | 'payto' | 'pix' | 'promptpay' | 'qris' | 'rechnung' | 'revolut_pay' | 'samsung_pay' | 'satispay' | 'scalapay' | 'sepa_debit' | 'shopeepay' | 'sofort' | 'stripe_balance' | 'sunbit' | 'swish' | 'tamara' | 'twint' | 'upi' | 'us_bank_account' | 'wechat_pay' | 'zip';
+    type AllowedPaymentMethodType = 'acss_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'alma' | 'amazon_pay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'billie' | 'bizum' | 'blik' | 'boku_promptpay' | 'boleto' | 'capchase_pay' | 'card' | 'cashapp' | 'check_scan' | 'click_to_pay' | 'crypto' | 'customer_balance' | 'demo_pay' | 'duitnow' | 'dummy_auth_push' | 'dummy_passthrough_card' | 'edenred' | 'eps' | 'fpx' | 'gcash' | 'getbalance' | 'gift_card' | 'giropay' | 'gopay' | 'grabpay' | 'id_bank_transfer' | 'ideal' | 'kakao_pay' | 'klarna' | 'knet' | 'konbini' | 'kr_card' | 'kr_market' | 'kriya' | 'link' | 'mb_way' | 'mobilepay' | 'momo' | 'mondu' | 'multibanco' | 'naver_pay' | 'netbanking' | 'ng_bank' | 'ng_bank_transfer' | 'ng_card' | 'ng_market' | 'ng_ussd' | 'ng_wallet' | 'nz_bank_account' | 'octopus' | 'oxxo' | 'p24' | 'paper_check' | 'pay_by_bank' | 'payco' | 'paynow' | 'paypal' | 'paypay' | 'payto' | 'pix' | 'promptpay' | 'qris' | 'rechnung' | 'revolut_pay' | 'samsung_pay' | 'satispay' | 'scalapay' | 'sepa_debit' | 'sequra' | 'shop_pay' | 'shopeepay' | 'sofort' | 'south_korea_market' | 'stripe_balance' | 'sunbit' | 'swish' | 'tamara' | 'test_pay' | 'truemoney' | 'twint' | 'upi' | 'us_bank_account' | 'us_cash_voucher' | 'vipps' | 'wechat_pay' | 'wero' | 'zip';
     interface AmountDetails {
         /**
          * The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0.
@@ -14414,6 +14466,16 @@ export declare namespace PaymentIntentUpdateParams {
              * If `capture_method` is already set on the PaymentIntent, providing an empty value for this parameter unsets the stored value for this payment method type.
              */
             capture_method?: Emptyable<'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://docs.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://docs.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://docs.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://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: Emptyable<Paypay.SetupFutureUsage>;
         }
         interface Payto {
             /**
@@ -16141,6 +16203,9 @@ export declare namespace PaymentIntentUpdateParams {
                 }
             }
         }
+        namespace Paypay {
+            type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
+        }
         namespace Payto {
             interface MandateOptions {
                 /**
@@ -18333,7 +18398,7 @@ export declare namespace PaymentIntentConfirmParams {
          */
         enabled?: boolean;
     }
-    type AllowedPaymentMethodType = 'acss_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'alma' | 'amazon_pay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'billie' | 'bizum' | 'blik' | 'boleto' | 'card' | 'cashapp' | 'crypto' | 'customer_balance' | 'eps' | 'fpx' | 'gift_card' | 'giropay' | 'gopay' | 'grabpay' | 'id_bank_transfer' | 'ideal' | 'kakao_pay' | 'klarna' | 'konbini' | 'kr_card' | 'link' | 'mb_way' | 'mobilepay' | 'multibanco' | 'naver_pay' | 'nz_bank_account' | 'oxxo' | 'p24' | 'pay_by_bank' | 'payco' | 'paynow' | 'paypal' | 'paypay' | 'payto' | 'pix' | 'promptpay' | 'qris' | 'rechnung' | 'revolut_pay' | 'samsung_pay' | 'satispay' | 'scalapay' | 'sepa_debit' | 'shopeepay' | 'sofort' | 'stripe_balance' | 'sunbit' | 'swish' | 'tamara' | 'twint' | 'upi' | 'us_bank_account' | 'wechat_pay' | 'zip';
+    type AllowedPaymentMethodType = 'acss_debit' | 'affirm' | 'afterpay_clearpay' | 'alipay' | 'alma' | 'amazon_pay' | 'au_becs_debit' | 'bacs_debit' | 'bancontact' | 'billie' | 'bizum' | 'blik' | 'boku_promptpay' | 'boleto' | 'capchase_pay' | 'card' | 'cashapp' | 'check_scan' | 'click_to_pay' | 'crypto' | 'customer_balance' | 'demo_pay' | 'duitnow' | 'dummy_auth_push' | 'dummy_passthrough_card' | 'edenred' | 'eps' | 'fpx' | 'gcash' | 'getbalance' | 'gift_card' | 'giropay' | 'gopay' | 'grabpay' | 'id_bank_transfer' | 'ideal' | 'kakao_pay' | 'klarna' | 'knet' | 'konbini' | 'kr_card' | 'kr_market' | 'kriya' | 'link' | 'mb_way' | 'mobilepay' | 'momo' | 'mondu' | 'multibanco' | 'naver_pay' | 'netbanking' | 'ng_bank' | 'ng_bank_transfer' | 'ng_card' | 'ng_market' | 'ng_ussd' | 'ng_wallet' | 'nz_bank_account' | 'octopus' | 'oxxo' | 'p24' | 'paper_check' | 'pay_by_bank' | 'payco' | 'paynow' | 'paypal' | 'paypay' | 'payto' | 'pix' | 'promptpay' | 'qris' | 'rechnung' | 'revolut_pay' | 'samsung_pay' | 'satispay' | 'scalapay' | 'sepa_debit' | 'sequra' | 'shop_pay' | 'shopeepay' | 'sofort' | 'south_korea_market' | 'stripe_balance' | 'sunbit' | 'swish' | 'tamara' | 'test_pay' | 'truemoney' | 'twint' | 'upi' | 'us_bank_account' | 'us_cash_voucher' | 'vipps' | 'wechat_pay' | 'wero' | 'zip';
     interface AmountDetails {
         /**
          * The total discount applied on the transaction represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). An integer greater than 0.
@@ -22136,6 +22201,16 @@ export declare namespace PaymentIntentConfirmParams {
              * If `capture_method` is already set on the PaymentIntent, providing an empty value for this parameter unsets the stored value for this payment method type.
              */
             capture_method?: Emptyable<'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://docs.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://docs.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://docs.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://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: Emptyable<Paypay.SetupFutureUsage>;
         }
         interface Payto {
             /**
@@ -23863,6 +23938,9 @@ export declare namespace PaymentIntentConfirmParams {
                 }
             }
         }
+        namespace Paypay {
+            type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
+        }
         namespace Payto {
             interface MandateOptions {
                 /**

package/cjs/resources/PaymentIntents.js.map

@@ -1 +1 @@
-{"version":3,"file":"PaymentIntents.js","sourceRoot":"","sources":["../../src/resources/PaymentIntents.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;AAEvC,4DAAoD;AA8BpD,MAAa,qBAAsB,SAAQ,kCAAc;IACvD;;OAEG;IACH,IAAI,CACF,MAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,OAAO,EAAE;YACtE,UAAU,EAAE,MAAM;SACnB,CAAQ,CAAC;IACZ,CAAC;IACD;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,MAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,qBAAqB,EACrB,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;OAMG;IACH,QAAQ,CACN,EAAU,EACV,MAAoC,EACpC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAC/C,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;;;OAQG;IACH,MAAM,CACJ,EAAU,EACV,MAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAC/C,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;OAKG;IACH,MAAM,CACJ,MAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,4BAA4B,EAC5B,MAAM,EACN,OAAO,EACP;YACE,UAAU,EAAE,QAAQ;SACrB,CACK,CAAC;IACX,CAAC;IACD;;OAEG;IACH,oBAAoB,CAClB,EAAU,EACV,MAAgD,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,yBAAyB,EACtE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;OAMG;IACH,MAAM,CACJ,EAAU,EACV,MAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EACtD,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;OAMG;IACH,OAAO,CACL,EAAU,EACV,MAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EACvD,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,OAAO,CACL,EAAU,EACV,MAAmC,EACnC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EACvD,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;;;;;;;;;;;;OAiBG;IACH,sBAAsB,CACpB,EAAU,EACV,MAAiD,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,0BAA0B,EACvE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,sBAAsB,CACpB,EAAU,EACV,MAAiD,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,0BAA0B,EACvE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;;;;;;;OASG;IACH,WAAW,CACT,EAAU,EACV,MAAuC,EACvC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,cAAc,EAC3D,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,yBAAyB,CACvB,EAAU,EACV,MAAoD,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CACvC,EAAE,CACH,+BAA+B,EAChC,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,mBAAmB,CACjB,EAAU,EACV,MAA+C,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,uBAAuB,EACpE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,aAAa,CACX,EAAU,EACV,MAAwC,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,4BAA4B,kBAAkB,CAAC,EAAE,CAAC,iBAAiB,EACnE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,0BAA0B,CACxB,EAAU,EACV,MAAsD,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,uBAAuB,kBAAkB,CAAC,EAAE,CAAC,4BAA4B,EACzE,MAAM,EACN,OAAO,EACP;YACE,UAAU,EAAE,MAAM;SACnB,CACK,CAAC;IACX,CAAC;CACF;AA7VD,sDA6VC"}
+{"version":3,"file":"PaymentIntents.js","sourceRoot":"","sources":["../../src/resources/PaymentIntents.ts"],"names":[],"mappings":"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"}

package/cjs/resources/PaymentMethods.d.ts

@@ -472,7 +472,7 @@ export declare namespace PaymentMethod {
          */
         account_holder_type: Fpx.AccountHolderType | null;
         /**
-         * The customer's bank, if provided. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
+         * The customer's bank, if provided. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bnp_paribas`, `bank_rakyat`, `bsn`, `cimb`, `citibank`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `mbsb_bank`, `pb_enterprise`, or `bank_of_china`.
          */
         bank: Fpx.Bank;
     }
@@ -1223,7 +1223,7 @@ export declare namespace PaymentMethod {
     }
     namespace Fpx {
         type AccountHolderType = 'company' | 'individual';
-        type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bsn' | 'cimb' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
+        type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bnp_paribas' | 'bsn' | 'cimb' | 'citibank' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'mbsb_bank' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
     }
     namespace GiftCard {
         type Brand = 'fiserv_valuelink' | 'givex' | 'svs';

package/cjs/resources/PaymentRecords.d.ts

@@ -890,7 +890,7 @@ export declare namespace PaymentRecord {
              */
             account_holder_type: Fpx.AccountHolderType | null;
             /**
-             * The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
+             * The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bnp_paribas`, `bank_rakyat`, `bsn`, `cimb`, `citibank`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `mbsb_bank`, `pb_enterprise`, or `bank_of_china`.
              */
             bank: Fpx.Bank;
             /**
@@ -1603,7 +1603,7 @@ export declare namespace PaymentRecord {
             namespace Funding {
                 interface Card {
                     /**
-                     * Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
+                     * Card brand. Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
                      */
                     brand: string | null;
                     /**
@@ -1845,7 +1845,7 @@ export declare namespace PaymentRecord {
         }
         namespace Fpx {
             type AccountHolderType = 'company' | 'individual';
-            type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bsn' | 'cimb' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
+            type Bank = 'affin_bank' | 'agrobank' | 'alliance_bank' | 'ambank' | 'bank_islam' | 'bank_muamalat' | 'bank_of_china' | 'bank_rakyat' | 'bnp_paribas' | 'bsn' | 'cimb' | 'citibank' | 'deutsche_bank' | 'hong_leong_bank' | 'hsbc' | 'kfh' | 'maybank2e' | 'maybank2u' | 'mbsb_bank' | 'ocbc' | 'pb_enterprise' | 'public_bank' | 'rhb' | 'standard_chartered' | 'uob';
         }
         namespace GiftCard {
             interface Balance {

package/cjs/resources/Persons.d.ts

@@ -224,7 +224,7 @@ export declare namespace Person {
          */
         currently_due: Array<string>;
         /**
-         * Details about validation and verification failures for `due` requirements that must be resolved.
+         * Fields that are `currently_due` and need to be collected again because validation or verification failed.
          */
         errors: Array<FutureRequirements.Error>;
         /**
@@ -285,7 +285,7 @@ export declare namespace Person {
          */
         currently_due: Array<string>;
         /**
-         * Details about validation and verification failures for `due` requirements that must be resolved.
+         * Fields that are `currently_due` and need to be collected again because validation or verification failed.
          */
         errors: Array<Requirements.Error>;
         /**

package/cjs/resources/PromotionCodes.d.ts

@@ -178,7 +178,7 @@ export declare namespace PromotionCodeCreateParams {
     }
     interface Restrictions {
         /**
-         * Promotion codes defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
+         * Promotion codes defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies). Each currency must be different from the `minimum_amount_currency` set on the promotion code.
          */
         currency_options?: {
             [key: string]: Restrictions.CurrencyOptions;
@@ -232,7 +232,7 @@ export interface PromotionCodeUpdateParams {
 export declare namespace PromotionCodeUpdateParams {
     interface Restrictions {
         /**
-         * Promotion codes defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
+         * Promotion codes defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies). Each currency must be different from the `minimum_amount_currency` set on the promotion code.
          */
         currency_options?: {
             [key: string]: Restrictions.CurrencyOptions;

package/cjs/resources/QuotePreviewInvoices.d.ts

@@ -10,6 +10,7 @@ import { InvoiceLineItem } from './InvoiceLineItems.js';
 import { Account } from './Accounts.js';
 import { InvoicePayment } from './InvoicePayments.js';
 import { Subscription } from './Subscriptions.js';
+import { GiftCardOperation } from './GiftCardOperations.js';
 import { PaymentIntent } from './PaymentIntents.js';
 import { SetupIntent } from './SetupIntents.js';
 import { ShippingRate } from './ShippingRates.js';
@@ -486,6 +487,11 @@ export declare namespace QuotePreviewInvoice {
          * A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
          */
         doc_url?: string;
+        /**
+         * A GiftCardOperation represents an operation performed on a third-party gift card,
+         * such as activation, reload, cashout, balance check, or void.
+         */
+        gift_card_operation?: GiftCardOperation;
         /**
          * A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
          */

package/cjs/resources/QuotePreviewSubscriptionSchedules.d.ts

@@ -429,10 +429,22 @@ export declare namespace QuotePreviewSubscriptionSchedule {
              * The account tax IDs associated with the subscription schedule. Will be set on invoices generated by the subscription schedule.
              */
             account_tax_ids: Array<string | TaxId | DeletedTaxId> | null;
+            /**
+             * A list of up to 4 custom fields to be displayed on the invoice.
+             */
+            custom_fields: Array<InvoiceSettings.CustomField> | null;
             /**
              * Number of days within which a customer must pay invoices generated by this subscription schedule. This value will be `null` for subscription schedules where `billing=charge_automatically`.
              */
             days_until_due: number | null;
+            /**
+             * An arbitrary string attached to the object. Often useful for displaying to users.
+             */
+            description: string | null;
+            /**
+             * Footer to be displayed on the invoice.
+             */
+            footer: string | null;
             issuer: InvoiceSettings.Issuer;
         }
         type PhaseEffectiveAt = 'billing_period_start' | 'phase_start';
@@ -462,6 +474,16 @@ export declare namespace QuotePreviewSubscriptionSchedule {
             }
         }
         namespace InvoiceSettings {
+            interface CustomField {
+                /**
+                 * The name of the custom field.
+                 */
+                name: string;
+                /**
+                 * The value of the custom field.
+                 */
+                value: string;
+            }
             interface Issuer {
                 /**
                  * The connected account being referenced when `type` is `account`.
@@ -568,10 +590,22 @@ export declare namespace QuotePreviewSubscriptionSchedule {
              * The account tax IDs associated with this phase of the subscription schedule. Will be set on invoices generated by this phase of the subscription schedule.
              */
             account_tax_ids: Array<string | TaxId | DeletedTaxId> | null;
+            /**
+             * A list of up to 4 custom fields to be displayed on the invoice.
+             */
+            custom_fields: Array<InvoiceSettings.CustomField> | null;
             /**
              * Number of days within which a customer must pay invoices generated by this subscription schedule. This value will be `null` for subscription schedules where `billing=charge_automatically`.
              */
             days_until_due: number | null;
+            /**
+             * An arbitrary string attached to the object. Often useful for displaying to users.
+             */
+            description: string | null;
+            /**
+             * Footer to be displayed on the invoice.
+             */
+            footer: string | null;
             /**
              * The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
              */
@@ -773,6 +807,16 @@ export declare namespace QuotePreviewSubscriptionSchedule {
             }
         }
         namespace InvoiceSettings {
+            interface CustomField {
+                /**
+                 * The name of the custom field.
+                 */
+                name: string;
+                /**
+                 * The value of the custom field.
+                 */
+                value: string;
+            }
             interface Issuer {
                 /**
                  * The connected account being referenced when `type` is `account`.