stripe 17.2.1 → 17.3.0

package/types/PaymentLinks.d.ts

@@ -542,6 +542,7 @@ declare module 'stripe' {
         | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
+        | 'alma'
         | 'au_becs_debit'
         | 'bacs_debit'
         | 'bancontact'

package/types/PaymentLinksResource.d.ts

@@ -601,6 +601,7 @@ declare module 'stripe' {
         | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
+        | 'alma'
         | 'au_becs_debit'
         | 'bacs_debit'
         | 'bancontact'
@@ -1525,6 +1526,7 @@ declare module 'stripe' {
         | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
+        | 'alma'
         | 'au_becs_debit'
         | 'bacs_debit'
         | 'bancontact'

package/types/PaymentMethodConfigurations.d.ts

@@ -42,6 +42,8 @@ declare module 'stripe' {
 
       alipay?: PaymentMethodConfiguration.Alipay;
 
+      alma?: PaymentMethodConfiguration.Alma;
+
       amazon_pay?: PaymentMethodConfiguration.AmazonPay;
 
       apple_pay?: PaymentMethodConfiguration.ApplePay;
@@ -277,6 +279,40 @@ declare module 'stripe' {
         }
       }
 
+      interface Alma {
+        /**
+         * Whether this payment method may be offered at checkout. True if `display_preference` is `on` and the payment method's capability is active.
+         */
+        available: boolean;
+
+        display_preference: Alma.DisplayPreference;
+      }
+
+      namespace Alma {
+        interface DisplayPreference {
+          /**
+           * For child configs, whether or not the account's preference will be observed. If `false`, the parent configuration's default is used.
+           */
+          overridable: boolean | null;
+
+          /**
+           * The account's display preference.
+           */
+          preference: DisplayPreference.Preference;
+
+          /**
+           * The effective display preference value.
+           */
+          value: DisplayPreference.Value;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+
+          type Value = 'off' | 'on';
+        }
+      }
+
       interface AmazonPay {
         /**
          * Whether this payment method may be offered at checkout. True if `display_preference` is `on` and the payment method's capability is active.

package/types/PaymentMethodConfigurationsResource.d.ts

@@ -23,6 +23,11 @@ declare module 'stripe' {
        */
       alipay?: PaymentMethodConfigurationCreateParams.Alipay;
 
+      /**
+       * Alma is a Buy Now, Pay Later payment method that offers customers the ability to pay in 2, 3, or 4 installments.
+       */
+      alma?: PaymentMethodConfigurationCreateParams.Alma;
+
       /**
        * Amazon Pay is a wallet payment method that lets your customers check out the same way as on Amazon.
        */
@@ -209,7 +214,7 @@ declare module 'stripe' {
       twint?: PaymentMethodConfigurationCreateParams.Twint;
 
       /**
-       * Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-debit) for more details.
+       * Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-direct-debit) for more details.
        */
       us_bank_account?: PaymentMethodConfigurationCreateParams.UsBankAccount;
 
@@ -305,6 +310,26 @@ declare module 'stripe' {
         }
       }
 
+      interface Alma {
+        /**
+         * Whether or not the payment method should be displayed.
+         */
+        display_preference?: Alma.DisplayPreference;
+      }
+
+      namespace Alma {
+        interface DisplayPreference {
+          /**
+           * The account's preference for whether or not to display this payment method.
+           */
+          preference?: DisplayPreference.Preference;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+        }
+      }
+
       interface AmazonPay {
         /**
          * Whether or not the payment method should be displayed.
@@ -1079,6 +1104,11 @@ declare module 'stripe' {
        */
       alipay?: PaymentMethodConfigurationUpdateParams.Alipay;
 
+      /**
+       * Alma is a Buy Now, Pay Later payment method that offers customers the ability to pay in 2, 3, or 4 installments.
+       */
+      alma?: PaymentMethodConfigurationUpdateParams.Alma;
+
       /**
        * Amazon Pay is a wallet payment method that lets your customers check out the same way as on Amazon.
        */
@@ -1260,7 +1290,7 @@ declare module 'stripe' {
       twint?: PaymentMethodConfigurationUpdateParams.Twint;
 
       /**
-       * Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-debit) for more details.
+       * Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this [page](https://stripe.com/docs/payments/ach-direct-debit) for more details.
        */
       us_bank_account?: PaymentMethodConfigurationUpdateParams.UsBankAccount;
 
@@ -1356,6 +1386,26 @@ declare module 'stripe' {
         }
       }
 
+      interface Alma {
+        /**
+         * Whether or not the payment method should be displayed.
+         */
+        display_preference?: Alma.DisplayPreference;
+      }
+
+      namespace Alma {
+        interface DisplayPreference {
+          /**
+           * The account's preference for whether or not to display this payment method.
+           */
+          preference?: DisplayPreference.Preference;
+        }
+
+        namespace DisplayPreference {
+          type Preference = 'none' | 'off' | 'on';
+        }
+      }
+
       interface AmazonPay {
         /**
          * Whether or not the payment method should be displayed.

package/types/PaymentMethodDomains.d.ts

@@ -19,6 +19,11 @@ declare module 'stripe' {
        */
       object: 'payment_method_domain';
 
+      /**
+       * Indicates the status of a specific payment method on a payment method domain.
+       */
+      amazon_pay: PaymentMethodDomain.AmazonPay;
+
       /**
        * Indicates the status of a specific payment method on a payment method domain.
        */
@@ -61,6 +66,29 @@ declare module 'stripe' {
     }
 
     namespace PaymentMethodDomain {
+      interface AmazonPay {
+        /**
+         * The status of the payment method on the domain.
+         */
+        status: AmazonPay.Status;
+
+        /**
+         * Contains additional details about the status of a payment method for a specific payment method domain.
+         */
+        status_details?: AmazonPay.StatusDetails;
+      }
+
+      namespace AmazonPay {
+        type Status = 'active' | 'inactive';
+
+        interface StatusDetails {
+          /**
+           * The error message associated with the status of the payment method on the domain.
+           */
+          error_message: string;
+        }
+      }
+
       interface ApplePay {
         /**
          * The status of the payment method on the domain.

package/types/PaymentMethods.d.ts

@@ -33,6 +33,8 @@ declare module 'stripe' {
        */
       allow_redisplay?: PaymentMethod.AllowRedisplay;
 
+      alma?: PaymentMethod.Alma;
+
       amazon_pay?: PaymentMethod.AmazonPay;
 
       au_becs_debit?: PaymentMethod.AuBecsDebit;
@@ -77,10 +79,14 @@ declare module 'stripe' {
 
       interac_present?: PaymentMethod.InteracPresent;
 
+      kakao_pay?: PaymentMethod.KakaoPay;
+
       klarna?: PaymentMethod.Klarna;
 
       konbini?: PaymentMethod.Konbini;
 
+      kr_card?: PaymentMethod.KrCard;
+
       link?: PaymentMethod.Link;
 
       /**
@@ -97,10 +103,14 @@ declare module 'stripe' {
 
       multibanco?: PaymentMethod.Multibanco;
 
+      naver_pay?: PaymentMethod.NaverPay;
+
       oxxo?: PaymentMethod.Oxxo;
 
       p24?: PaymentMethod.P24;
 
+      payco?: PaymentMethod.Payco;
+
       paynow?: PaymentMethod.Paynow;
 
       paypal?: PaymentMethod.Paypal;
@@ -116,6 +126,8 @@ declare module 'stripe' {
 
       revolut_pay?: PaymentMethod.RevolutPay;
 
+      samsung_pay?: PaymentMethod.SamsungPay;
+
       sepa_debit?: PaymentMethod.SepaDebit;
 
       sofort?: PaymentMethod.Sofort;
@@ -172,6 +184,8 @@ declare module 'stripe' {
 
       type AllowRedisplay = 'always' | 'limited' | 'unspecified';
 
+      interface Alma {}
+
       interface AmazonPay {}
 
       interface AuBecsDebit {
@@ -1074,6 +1088,8 @@ declare module 'stripe' {
           | 'magnetic_stripe_track2';
       }
 
+      interface KakaoPay {}
+
       interface Klarna {
         /**
          * The customer's date of birth, if provided.
@@ -1102,6 +1118,44 @@ declare module 'stripe' {
 
       interface Konbini {}
 
+      interface KrCard {
+        /**
+         * The local credit or debit card brand.
+         */
+        brand: KrCard.Brand | 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 {
         /**
          * Account owner's email address.
@@ -1119,6 +1173,17 @@ declare module 'stripe' {
 
       interface Multibanco {}
 
+      interface NaverPay {
+        /**
+         * Whether to fund this transaction with Naver Pay points or a card.
+         */
+        funding: NaverPay.Funding;
+      }
+
+      namespace NaverPay {
+        type Funding = 'card' | 'points';
+      }
+
       interface Oxxo {}
 
       interface P24 {
@@ -1158,6 +1223,8 @@ declare module 'stripe' {
           | 'volkswagen_bank';
       }
 
+      interface Payco {}
+
       interface Paynow {}
 
       interface Paypal {
@@ -1186,6 +1253,8 @@ declare module 'stripe' {
 
       interface RevolutPay {}
 
+      interface SamsungPay {}
+
       interface SepaDebit {
         /**
          * Bank code of bank associated with the bank account.
@@ -1248,6 +1317,7 @@ declare module 'stripe' {
         | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
+        | 'alma'
         | 'amazon_pay'
         | 'au_becs_debit'
         | 'bacs_debit'
@@ -1264,18 +1334,23 @@ declare module 'stripe' {
         | 'grabpay'
         | 'ideal'
         | 'interac_present'
+        | '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'

package/types/PaymentMethodsResource.d.ts

@@ -28,6 +28,11 @@ declare module 'stripe' {
        */
       allow_redisplay?: PaymentMethodCreateParams.AllowRedisplay;
 
+      /**
+       * If this is a Alma PaymentMethod, this hash contains details about the Alma payment method.
+       */
+      alma?: PaymentMethodCreateParams.Alma;
+
       /**
        * If this is a AmazonPay PaymentMethod, this hash contains details about the AmazonPay payment method.
        */
@@ -118,6 +123,11 @@ declare module 'stripe' {
        */
       interac_present?: PaymentMethodCreateParams.InteracPresent;
 
+      /**
+       * If this is a `kakao_pay` PaymentMethod, this hash contains details about the Kakao Pay payment method.
+       */
+      kakao_pay?: PaymentMethodCreateParams.KakaoPay;
+
       /**
        * If this is a `klarna` PaymentMethod, this hash contains details about the Klarna payment method.
        */
@@ -128,6 +138,11 @@ declare module 'stripe' {
        */
       konbini?: PaymentMethodCreateParams.Konbini;
 
+      /**
+       * If this is a `kr_card` PaymentMethod, this hash contains details about the Korean Card payment method.
+       */
+      kr_card?: PaymentMethodCreateParams.KrCard;
+
       /**
        * If this is an `Link` PaymentMethod, this hash contains details about the Link payment method.
        */
@@ -148,6 +163,11 @@ declare module 'stripe' {
        */
       multibanco?: PaymentMethodCreateParams.Multibanco;
 
+      /**
+       * If this is a `naver_pay` PaymentMethod, this hash contains details about the Naver Pay payment method.
+       */
+      naver_pay?: PaymentMethodCreateParams.NaverPay;
+
       /**
        * If this is an `oxxo` PaymentMethod, this hash contains details about the OXXO payment method.
        */
@@ -158,6 +178,11 @@ declare module 'stripe' {
        */
       p24?: PaymentMethodCreateParams.P24;
 
+      /**
+       * If this is a `payco` PaymentMethod, this hash contains details about the PAYCO payment method.
+       */
+      payco?: PaymentMethodCreateParams.Payco;
+
       /**
        * The PaymentMethod to share.
        */
@@ -193,6 +218,11 @@ declare module 'stripe' {
        */
       revolut_pay?: PaymentMethodCreateParams.RevolutPay;
 
+      /**
+       * If this is a `samsung_pay` PaymentMethod, this hash contains details about the SamsungPay payment method.
+       */
+      samsung_pay?: PaymentMethodCreateParams.SamsungPay;
+
       /**
        * If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
        */
@@ -260,6 +290,8 @@ declare module 'stripe' {
 
       type AllowRedisplay = 'always' | 'limited' | 'unspecified';
 
+      interface Alma {}
+
       interface AmazonPay {}
 
       interface AuBecsDebit {
@@ -453,7 +485,7 @@ declare module 'stripe' {
 
       interface Ideal {
         /**
-         * The customer's bank.
+         * The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
          */
         bank?: Ideal.Bank;
       }
@@ -480,6 +512,8 @@ declare module 'stripe' {
 
       interface InteracPresent {}
 
+      interface KakaoPay {}
+
       interface Klarna {
         /**
          * Customer's date of birth
@@ -508,12 +542,25 @@ declare module 'stripe' {
 
       interface Konbini {}
 
+      interface KrCard {}
+
       interface Link {}
 
       interface Mobilepay {}
 
       interface Multibanco {}
 
+      interface NaverPay {
+        /**
+         * Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
+         */
+        funding?: NaverPay.Funding;
+      }
+
+      namespace NaverPay {
+        type Funding = 'card' | 'points';
+      }
+
       interface Oxxo {}
 
       interface P24 {
@@ -553,6 +600,8 @@ declare module 'stripe' {
           | 'volkswagen_bank';
       }
 
+      interface Payco {}
+
       interface Paynow {}
 
       interface Paypal {}
@@ -570,6 +619,8 @@ declare module 'stripe' {
 
       interface RevolutPay {}
 
+      interface SamsungPay {}
+
       interface SepaDebit {
         /**
          * IBAN of the bank account.
@@ -597,6 +648,7 @@ declare module 'stripe' {
         | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
+        | 'alma'
         | 'amazon_pay'
         | 'au_becs_debit'
         | 'bacs_debit'
@@ -611,18 +663,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'
@@ -707,6 +764,11 @@ declare module 'stripe' {
        */
       metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
+      /**
+       * If this is a `naver_pay` PaymentMethod, this hash contains details about the Naver Pay payment method.
+       */
+      naver_pay?: PaymentMethodUpdateParams.NaverPay;
+
       /**
        * If this is an `us_bank_account` PaymentMethod, this hash contains details about the US bank account payment method.
        */
@@ -770,6 +832,17 @@ declare module 'stripe' {
 
       interface Link {}
 
+      interface NaverPay {
+        /**
+         * Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
+         */
+        funding?: NaverPay.Funding;
+      }
+
+      namespace NaverPay {
+        type Funding = 'card' | 'points';
+      }
+
       interface UsBankAccount {
         /**
          * Bank account holder type.
@@ -812,6 +885,7 @@ declare module 'stripe' {
         | 'affirm'
         | 'afterpay_clearpay'
         | 'alipay'
+        | 'alma'
         | 'amazon_pay'
         | 'au_becs_debit'
         | 'bacs_debit'
@@ -826,18 +900,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'

package/types/Persons.d.ts

@@ -102,7 +102,7 @@ declare module 'stripe' {
       future_requirements?: Person.FutureRequirements | null;
 
       /**
-       * The person's gender (International regulations require either "male" or "female").
+       * The person's gender.
        */
       gender?: string | null;
 

package/types/Refunds.d.ts

@@ -113,6 +113,8 @@ declare module 'stripe' {
 
         alipay?: DestinationDetails.Alipay;
 
+        alma?: DestinationDetails.Alma;
+
         amazon_pay?: DestinationDetails.AmazonPay;
 
         au_bank_transfer?: DestinationDetails.AuBankTransfer;
@@ -180,6 +182,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface Alma {}
+
         interface AmazonPay {}
 
         interface AuBankTransfer {}
@@ -370,10 +374,7 @@ declare module 'stripe' {
       }
 
       interface NextAction {
-        /**
-         * Contains the refund details.
-         */
-        display_details: NextAction.DisplayDetails | null;
+        display_details?: NextAction.DisplayDetails;
 
         /**
          * Type of the next action to perform.

package/types/SetupAttempts.d.ts

@@ -110,8 +110,12 @@ declare module 'stripe' {
 
         ideal?: PaymentMethodDetails.Ideal;
 
+        kakao_pay?: PaymentMethodDetails.KakaoPay;
+
         klarna?: PaymentMethodDetails.Klarna;
 
+        kr_card?: PaymentMethodDetails.KrCard;
+
         link?: PaymentMethodDetails.Link;
 
         paypal?: PaymentMethodDetails.Paypal;
@@ -462,8 +466,12 @@ declare module 'stripe' {
             | 'TRIONL2U';
         }
 
+        interface KakaoPay {}
+
         interface Klarna {}
 
+        interface KrCard {}
+
         interface Link {}
 
         interface Paypal {}