# Adds support for new South Korean payment methods

## What’s new

Adds support for several new South Korean payment methods:

- [South Korean cards](https://docs.stripe.com/payments/kr-card/accept-a-payment.md)
- [Naver Pay](https://docs.stripe.com/payments/naver-pay/accept-a-payment.md)
- [Kakao Pay](https://docs.stripe.com/payments/kakao-pay/accept-a-payment.md)
- [Samsung Pay](https://docs.stripe.com/payments/samsung-pay/accept-a-payment.md)
- [PAYCO](https://docs.stripe.com/payments/payco/accept-a-payment.md)

You can use these payment methods with any of the following integration paths:

- [Checkout](https://docs.stripe.com/payments/checkout.md)
- [Elements](https://docs.stripe.com/payments/elements.md)
- [Payment Links](https://docs.stripe.com/payment-links.md)
- [Billing](https://docs.stripe.com/billing.md)
- [Invoicing](https://docs.stripe.com/invoicing/overview.md)

## Impact

Wallets and cards are popular payment methods in South Korea, with a variety of local card issuers but no single predominant brand. To provide familiar payment options and increase conversion rates, you can now offer the majority of payment methods available in South Korea to your customers.

You can now use these South Korean payments with:

- [capture_method](https://docs.stripe.com/api/payment_intents/update.md?api-version=2024-10-28.acacia#update_payment_intent-capture_method): This lets you [place a hold on a payment method](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md).

- [setup_future_usage](https://docs.stripe.com/api/payment_intents/object.md?api-version=2024-10-28.acacia#payment_intent_object-setup_future_usage): This lets you [save payment details during payment](https://docs.stripe.com/payments/save-during-payment.md) and charge the payment method later.

This makes it easier to use the South Korean payment methods with [Apps by Stripe](https://docs.stripe.com/use-stripe-apps.md).

## Changes

#### REST API

| Parameters                                                                                               | Change | Resources or endpoints                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`                                                                                   | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationToken.testHelpers#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [Mandate.payment_method_details](/api/mandates/object?api-version=2024-10-28.acacia#mandate_object-payment_method_details), [PaymentIntent#confirm.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntent#confirm.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntent#create.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntent#create.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntent#update.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntent#update.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethod#create](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupAttempt.payment_method_details](/api/setup_attempts/object?api-version=2024-10-28.acacia#setup_attempt_object-payment_method_details), [SetupIntent#confirm.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntent#create.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntent#update.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data) |
| `naver_pay`                                                                                              | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationToken.testHelpers#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [PaymentIntent#confirm.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntent#confirm.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntent#create.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntent#create.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntent#update.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntent#update.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethod#create](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod#update](/api/payment_methods/update?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntent#confirm.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntent#create.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntent#update.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data)                                                                                                                                                                                       |
| `payco`, `samsung_pay`                                                                                   | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationToken.testHelpers#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [PaymentIntent#confirm.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntent#confirm.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntent#create.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntent#create.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntent#update.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntent#update.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethod#create](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntent#confirm.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntent#create.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntent#update.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data)                                                                                                                                                                                                                                                                          |
| `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, `samsung_pay_payments` | Added  | [Account#create.capabilities](/api/accounts/create?api-version=2024-10-28.acacia#create_account-capabilities), [Account#update.capabilities](/api/accounts/update?api-version=2024-10-28.acacia#update_account-capabilities), [Account.capabilities](/api/accounts/object?api-version=2024-10-28.acacia#account_object-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                              | Added  | [Checkout.Session#create.payment_method_options](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_options), [Checkout.Session.payment_method_options](/api/checkout/sessions/object?api-version=2024-10-28.acacia#checkout_session_object-payment_method_options)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

| Values                                                      | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [Checkout.Session#create.payment_method_types[]](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_types), [Customer#list_payment_methods.type](/api/payment_methods/customer_list?api-version=2024-10-28.acacia#list_customer_payment_methods-type), [PaymentMethod#create.type](/api/payment_methods/create?api-version=2024-10-28.acacia#create_payment_method-type), [PaymentMethod#list.type](/api/payment_methods/list?api-version=2024-10-28.acacia#list_payment_methods-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [ConfirmationToken.testHelpers#create.payment_method_data.type](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data-type), [PaymentIntent#confirm.payment_method_data.type](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data-type), [PaymentIntent#create.payment_method_data.type](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data-type), [PaymentIntent#update.payment_method_data.type](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data-type), [SetupIntent#confirm.payment_method_data.type](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data-type), [SetupIntent#create.payment_method_data.type](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data-type), [SetupIntent#update.payment_method_data.type](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data-type) |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`                | Added  | [Invoice#create.payment_settings.payment_method_types[]](/api/invoices/create?api-version=2024-10-28.acacia#create_invoice-payment_settings-payment_method_types), [Invoice#update.payment_settings.payment_method_types[]](/api/invoices/update?api-version=2024-10-28.acacia#update_invoice-payment_settings-payment_method_types), [Invoice.payment_settings.payment_method_types[]](/api/invoices/object?api-version=2024-10-28.acacia#invoice_object-payment_settings-payment_method_types), [Subscription#create.payment_settings.payment_method_types[]](/api/subscriptions/create?api-version=2024-10-28.acacia#create_subscription-payment_settings-payment_method_types), [Subscription#update.payment_settings.payment_method_types[]](/api/subscriptions/update?api-version=2024-10-28.acacia#update_subscription-payment_settings-payment_method_types), [Subscription.payment_settings.payment_method_types[]](/api/subscriptions/object?api-version=2024-10-28.acacia#subscription_object-payment_settings-payment_method_types)                                                                                |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [ConfirmationToken.payment_method_preview.type](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview-type), [PaymentMethod.type](/api/payment_methods/object?api-version=2024-10-28.acacia#payment_method_object-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

#### Ruby

This change does not affect the Ruby SDK.

#### Python

| Parameters                                                                                               | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, `samsung_pay_payments` | Added  | [stripe.Account.Capabilities](/api/accounts/object?api-version=2024-10-28.acacia#account_object-capabilities), [stripe.Account.CreateParamsCapabilities](/api/accounts/create?api-version=2024-10-28.acacia#create_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                              | Added  | [stripe.Charge.PaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [stripe.ConfirmationToken.PaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [stripe.PaymentIntent.PaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [stripe.ConfirmationToken.CreateParamsPaymentMethodData](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [stripe.PaymentIntent.ConfirmParamsPaymentMethodData](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [stripe.PaymentIntent.CreateParamsPaymentMethodData](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [stripe.PaymentIntent.CreateParamsPaymentMethodOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [stripe.PaymentIntent.ModifyParamsPaymentMethodData](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [stripe.PaymentIntent.ModifyParamsPaymentMethodOptions](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [stripe.PaymentMethod.CreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [stripe.SetupIntent.ConfirmParamsPaymentMethodData](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [stripe.SetupIntent.CreateParamsPaymentMethodData](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [stripe.SetupIntent.ModifyParamsPaymentMethodData](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data), [stripe.PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia) |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                              | Added  | [stripe.checkout.Session.CreateParamsPaymentMethodOptions](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_options), [stripe.checkout.Session.PaymentMethodOptions](/api/checkout/sessions/object?api-version=2024-10-28.acacia#checkout_session_object-payment_method_options)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

| Values                                                      | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [stripe.checkout.Session.CreateParams.payment_method_types](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_types), [stripe.ConfirmationToken.PaymentMethodPreview.type](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview-type), [stripe.ConfirmationToken.CreateParamsPaymentMethodData.type](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview-type), [stripe.Customer.ListPaymentMethodsParams.type](/api/payment_methods/customer_list?api-version=2024-10-28.acacia#list_customer_payment_methods-type), [stripe.Invoice.PaymentSettings.payment_method_types](/api/invoices/object?api-version=2024-10-28.acacia#invoice_object-payment_settings-payment_method_types), [stripe.Invoice.CreateParamsPaymentSettings.payment_method_types](/api/invoices/create?api-version=2024-10-28.acacia#create_invoice-payment_settings-payment_method_types), [stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types](/api/invoices/update?api-version=2024-10-28.acacia#update_invoice-payment_settings-payment_method_types), [stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data-type), [stripe.PaymentIntent.CreateParamsPaymentMethodData.type](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data-type), [stripe.PaymentIntent.ModifyParamsPaymentMethodData.type](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data-type), [stripe.PaymentMethod.type](/api/payment_methods/object?api-version=2024-10-28.acacia#payment_method_object-type), [stripe.PaymentMethod.CreateParams.type](/api/payment_methods/create?api-version=2024-10-28.acacia#create_payment_method-type), [stripe.PaymentMethod.ListParams.type](/api/payment_methods/list?api-version=2024-10-28.acacia#list_payment_methods-type), [stripe.SetupIntent.ConfirmParamsPaymentMethodData.type](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data-type), [stripe.SetupIntent.CreateParamsPaymentMethodData.type](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data-type), [stripe.SetupIntent.ModifyParamsPaymentMethodData.type](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data-type), [stripe.Subscription.PaymentSettings.payment_method_types](/api/subscriptions/object?api-version=2024-10-28.acacia#subscription_object-payment_settings-payment_method_types), [stripe.Subscription.CreateParamsPaymentSettings.payment_method_types](/api/subscriptions/create?api-version=2024-10-28.acacia#create_subscription-payment_settings-payment_method_types), [stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types](/api/subscriptions/update?api-version=2024-10-28.acacia#update_subscription-payment_settings-payment_method_types) |

#### PHP

| Parameters                                                  | Change | Resources or methods                                                       |
| ----------------------------------------------------------- | ------ | -------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia) |

| Values                                                              | Change | Enum                                                                                                       |
| ------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| `alma`, `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [PaymentMethod.type](/api/payment_methods/object?api-version=2024-10-28.acacia#payment_method_object-type) |

#### Java

| Parameters                                                                                               | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`                                                                                   | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [Mandate.payment_method_details](/api/mandates/object?api-version=2024-10-28.acacia#mandate_object-payment_method_details), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupAttempt.payment_method_details](/api/setup_attempts/object?api-version=2024-10-28.acacia#setup_attempt_object-payment_method_details), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data) |
| `naver_pay`                                                                                              | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethodUpdateParams](/api/payment_methods/update?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data)                                                                                                                                                                                  |
| `payco`, `samsung_pay`                                                                                   | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data)                                                                                                                                                                                                                                                                          |
| `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, `samsung_pay_payments` | Added  | [Account.capabilities](/api/accounts/object?api-version=2024-10-28.acacia#account_object-capabilities), [AccountCreateParams.capabilities](/api/accounts/create?api-version=2024-10-28.acacia#create_account-capabilities), [AccountUpdateParams.capabilities](/api/accounts/update?api-version=2024-10-28.acacia#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                              | Added  | [CheckoutSessionCreateParams.payment_method_options](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_options), [Checkout.Session.payment_method_options](/api/checkout/sessions/object?api-version=2024-10-28.acacia#checkout_session_object-payment_method_options)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

| Values                                                      | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [CustomerListPaymentMethodsParams.type](/api/payment_methods/customer_list?api-version=2024-10-28.acacia#list_customer_payment_methods-type), [PaymentMethodCreateParams.type](/api/payment_methods/create?api-version=2024-10-28.acacia#create_payment_method-type), [PaymentMethodListParams.type](/api/payment_methods/list?api-version=2024-10-28.acacia#list_payment_methods-type), [checkout.SessionCreateParams.payment_method_types[]](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [ConfirmationTokenCreateParams.payment_method_data.type](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data-type), [PaymentIntentConfirmParams.payment_method_data.type](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data-type), [PaymentIntentCreateParams.payment_method_data.type](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data-type), [PaymentIntentUpdateParams.payment_method_data.type](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data-type), [SetupIntentConfirmParams.payment_method_data.type](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data-type), [SetupIntentCreateParams.payment_method_data.type](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data-type), [SetupIntentUpdateParams.payment_method_data.type](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data-type) |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`                | Added  | [InvoiceCreateParams.payment_settings.payment_method_types[]](/api/invoices/create?api-version=2024-10-28.acacia#create_invoice-payment_settings-payment_method_types), [InvoiceUpdateParams.payment_settings.payment_method_types[]](/api/invoices/update?api-version=2024-10-28.acacia#update_invoice-payment_settings-payment_method_types), [SubscriptionCreateParams.payment_settings.payment_method_types[]](/api/subscriptions/create?api-version=2024-10-28.acacia#create_subscription-payment_settings-payment_method_types), [SubscriptionUpdateParams.payment_settings.payment_method_types[]](/api/subscriptions/update?api-version=2024-10-28.acacia#update_subscription-payment_settings-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                          |

#### Node.js

| Parameters                                                                                               | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`                                                                                   | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.testHelpers.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [Mandate.payment_method_details](/api/mandates/object?api-version=2024-10-28.acacia#mandate_object-payment_method_details), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupAttempt.payment_method_details](/api/setup_attempts/object?api-version=2024-10-28.acacia#setup_attempt_object-payment_method_details), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data) |
| `naver_pay`                                                                                              | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.testHelpers.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethodUpdateParams](/api/payment_methods/update?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data)                                                                                                                                                                                  |
| `payco`, `samsung_pay`                                                                                   | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.testHelpers.payment_method_data](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_options), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data)                                                                                                                                                                                                                                                                          |
| `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, `samsung_pay_payments` | Added  | [Account.capabilities](/api/accounts/object?api-version=2024-10-28.acacia#account_object-capabilities), [AccountCreateParams.capabilities](/api/accounts/create?api-version=2024-10-28.acacia#create_account-capabilities), [AccountUpdateParams.capabilities](/api/accounts/update?api-version=2024-10-28.acacia#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                              | Added  | [CheckoutSessionCreateParams.payment_method_options](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_options), [Checkout.Session.payment_method_options](/api/checkout/sessions/object?api-version=2024-10-28.acacia#checkout_session_object-payment_method_options)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

| Values                                                      | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [Checkout.SessionCreateParams.payment_method_types[]](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_types), [CustomerListPaymentMethodsParams.type](/api/payment_methods/customer_list?api-version=2024-10-28.acacia#list_customer_payment_methods-type), [PaymentMethodCreateParams.type](/api/payment_methods/create?api-version=2024-10-28.acacia#create_payment_method-type), [PaymentMethodListParams.type](/api/payment_methods/list?api-version=2024-10-28.acacia#list_payment_methods-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [ConfirmationTokenCreateParams.testHelpers.payment_method_data.type](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data-type), [PaymentIntentConfirmParams.payment_method_data.type](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data-type), [PaymentIntentCreateParams.payment_method_data.type](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data-type), [PaymentIntentUpdateParams.payment_method_data.type](/api/payment_intents/update?api-version=2024-10-28.acacia#update_payment_intent-payment_method_data-type), [SetupIntentConfirmParams.payment_method_data.type](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data-type), [SetupIntentCreateParams.payment_method_data.type](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data-type), [SetupIntentUpdateParams.payment_method_data.type](/api/setup_intents/update?api-version=2024-10-28.acacia#update_setup_intent-payment_method_data-type) |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`                | Added  | [Invoice.payment_settings.payment_method_types[]](/api/invoices/object?api-version=2024-10-28.acacia#invoice_object-payment_settings-payment_method_types), [InvoiceCreateParams.payment_settings.payment_method_types[]](/api/invoices/create?api-version=2024-10-28.acacia#create_invoice-payment_settings-payment_method_types), [InvoiceUpdateParams.payment_settings.payment_method_types[]](/api/invoices/update?api-version=2024-10-28.acacia#update_invoice-payment_settings-payment_method_types), [Subscription.payment_settings.payment_method_types[]](/api/subscriptions/object?api-version=2024-10-28.acacia#subscription_object-payment_settings-payment_method_types), [SubscriptionCreateParams.payment_settings.payment_method_types[]](/api/subscriptions/create?api-version=2024-10-28.acacia#create_subscription-payment_settings-payment_method_types), [SubscriptionUpdateParams.payment_settings.payment_method_types[]](/api/subscriptions/update?api-version=2024-10-28.acacia#update_subscription-payment_settings-payment_method_types)                                                                                               |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [ConfirmationToken.payment_method_preview.type](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview-type), [PaymentMethod.type](/api/payment_methods/object?api-version=2024-10-28.acacia#payment_method_object-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

#### Go

| Parameters                                                                                                      | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `KakaoPay`, `KrCard`                                                                                            | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataParams](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [MandatePaymentMethodDetails](/api/mandates/object?api-version=2024-10-28.acacia#mandate_object-payment_method_details), [PaymentIntentConfirmPaymentMethodDataParams](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmPaymentMethodOptionsParams](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentPaymentMethodDataParams](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsParams](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethodParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupAttemptPaymentMethodDetails](/api/setup_attempts/object?api-version=2024-10-28.acacia#setup_attempt_object-payment_method_details), [SetupIntentConfirmPaymentMethodDataParams](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentPaymentMethodDataParams](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data) |
| `NaverPay`                                                                                                      | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataParams](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [PaymentIntentConfirmPaymentMethodDataParams](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmPaymentMethodOptionsParams](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentPaymentMethodDataParams](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsParams](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethodParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentConfirmPaymentMethodDataParams](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentPaymentMethodDataParams](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data)                                                                                                                                                                                                                                                                    |
| `Payco`, `SamsungPay`                                                                                           | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataParams](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [PaymentIntentConfirmPaymentMethodDataParams](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmPaymentMethodOptionsParams](/api/payment_intents/confirm?api-version=2024-10-28.acacia#confirm_payment_intent-payment_method_options), [PaymentIntentPaymentMethodDataParams](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsParams](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethodParams](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentConfirmPaymentMethodDataParams](/api/setup_intents/confirm?api-version=2024-10-28.acacia#confirm_setup_intent-payment_method_data), [SetupIntentPaymentMethodDataParams](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data)                                                                                                                                                                                                                                                                    |
| `AlmaPayments`, `KakaoPayPayments`, `KrCardPayments`, `NaverPayPayments`, `PaycoPayments`, `SamsungPayPayments` | Added  | [AccountCapabilitiesParams](/api/accounts/create?api-version=2024-10-28.acacia#create_account-capabilities), [AccountCapabilities](/api/accounts/object?api-version=2024-10-28.acacia#account_object-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                                     | Added  | [CheckoutSessionPaymentMethodOptionsParams](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_options), [CheckoutSessionPaymentMethodOptions](/api/checkout/sessions/object?api-version=2024-10-28.acacia#checkout_session_object-payment_method_options)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

| Values                                                      | Change | Enums                                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay` | Added  | [ConfirmationTokenPaymentMethodPreviewType](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview-type), [PaymentMethodType](/api/payment_methods/object?api-version=2024-10-28.acacia#payment_method_object-type)                                             |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`                | Added  | [InvoicePaymentSettingsPaymentMethodTypes](/api/invoices/object?api-version=2024-10-28.acacia#invoice_object-payment_settings-payment_method_types), [SubscriptionPaymentSettingsPaymentMethodTypes](/api/subscriptions/object?api-version=2024-10-28.acacia#subscription_object-payment_settings-payment_method_types) |

#### .NET

| Parameters                                                                                      | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `KakaoPayPayments`, `KrCardPayments`, `NaverPayPayments`, `PaycoPayments`, `SamsungPayPayments` | Added  | [AccountCapabilitiesOptions](/api/accounts/create?api-version=2024-10-28.acacia#create_account-capabilities), [AccountCapabilities](/api/accounts/object?api-version=2024-10-28.acacia#account_object-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `KakaoPay`, `KrCard`                                                                            | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataOptions](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [MandatePaymentMethodDetails](/api/mandates/object?api-version=2024-10-28.acacia#mandate_object-payment_method_details), [PaymentIntentPaymentMethodDataOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethodCreateOptions](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupAttemptPaymentMethodDetails](/api/setup_attempts/object?api-version=2024-10-28.acacia#setup_attempt_object-payment_method_details), [SetupIntentPaymentMethodDataOptions](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data) |
| `NaverPay`                                                                                      | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataOptions](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [PaymentIntentPaymentMethodDataOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethodCreateOptions](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethodUpdateOptions](/api/payment_methods/update?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentPaymentMethodDataOptions](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data)                                                                                                                                                                           |
| `Payco`, `SamsungPay`                                                                           | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2024-10-28.acacia#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataOptions](/api/confirmation_tokens/test_create?api-version=2024-10-28.acacia#test_create-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2024-10-28.acacia#confirmation_token_object-payment_method_preview), [PaymentIntentPaymentMethodDataOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsOptions](/api/payment_intents/create?api-version=2024-10-28.acacia#create_payment_intent-payment_method_options), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2024-10-28.acacia#payment_intent_object-payment_method_options), [PaymentMethodCreateOptions](/api/payment_methods/create?api-version=2024-10-28.acacia), [PaymentMethod](/api/payment_methods/object?api-version=2024-10-28.acacia), [SetupIntentPaymentMethodDataOptions](/api/setup_intents/create?api-version=2024-10-28.acacia#create_setup_intent-payment_method_data)                                                                                                                                                                                                                                                                    |
| `kakao_pay`, `kr_card`, `naver_pay`, `payco`, `samsung_pay`                                     | Added  | [CheckoutSessionPaymentMethodOptionsParams](/api/checkout/sessions/create?api-version=2024-10-28.acacia#create_checkout_session-payment_method_options), [CheckoutSessionPaymentMethodOptions](/api/checkout/sessions/object?api-version=2024-10-28.acacia#checkout_session_object-payment_method_options)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Upgrade

#### REST API

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. If you use an SDK, upgrade to the corresponding SDK version for this API version.
   - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2024-10-28.acacia`
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Ruby SDK to [v13.1.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.1.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Python SDK to [v11.2.0](https://github.com/stripe/stripe-python/releases/tag/v11.2.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your PHP SDK to [v16.2.0](https://github.com/stripe/stripe-php/releases/tag/v16.2.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Java SDK to [v28.0.0](https://github.com/stripe/stripe-java/releases/tag/v28.0.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Node SDK to [v17.3.0](https://github.com/stripe/stripe-node/releases/tag/v17.3.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your Go SDK to [v81.0.0](https://github.com/stripe/stripe-go/releases/tag/v81.0.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench.
1. Upgrade your .NET SDK to [v47.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.0.0)
1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md).
1. [Test your integration](https://docs.stripe.com/testing.md) against the new version.
1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md).
1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours.

Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).

## Related changes

- [Adds support for Alma in France](https://docs.stripe.com/changelog/acacia/2024-10-28/alma.md)
