# Adds support for PayPay as a local payment method

## What’s new

Adds support for PayPay, a local payment method from Japan, for single-use payments through Stripe.

## Impact

If your business is located in Japan, you can now accept single-use [PayPay](https://docs.stripe.com/payments/paypay.md) payments from buyers.

## Changes

#### REST API

| Parameters        | Change | Resources or endpoints                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `paypay_payments` | Added  | [Account#create.capabilities](/api/accounts/create?api-version=2025-09-30.preview#create_account-capabilities), [Account#update.capabilities](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities), [Account.capabilities](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `paypay`          | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [ConfirmationToken.testHelpers#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [PaymentAttemptRecord.payment_method_details](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent#confirm.payment_method_data](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntent#confirm.payment_method_options](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntent#create.payment_method_data](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntent#create.payment_method_options](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentIntent#update.payment_method_data](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_data), [PaymentIntent#update.payment_method_options](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_options), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethod#create](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration#create](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfiguration#update](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentRecord.payment_method_details](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntent#confirm.payment_method_data](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntent#create.payment_method_data](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data), [SetupIntent#update.payment_method_data](/api/setup_intents/update?api-version=2025-09-30.preview#update_setup_intent-payment_method_data) |

| Values   | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `paypay` | Added  | [Checkout.Session#create](/api/checkout/sessions/create?api-version=2025-09-30.preview#create_checkout_session-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `paypay` | Added  | [ConfirmationToken.testHelpers#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntent#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntent#update.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntent#confirm.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntent#create.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntent#update.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntent#confirm.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type) |
| `paypay` | Added  | [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview-type), [PaymentMethod](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `paypay` | Added  | [Customer#list_payment_methods](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethod#list](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethod#create](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `paypay` | Added  | [PaymentIntent#create](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excluded_payment_method_types), [PaymentIntent](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excluded_payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `paypay` | Added  | [PaymentLink#create](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types), [PaymentLink#update](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types), [PaymentLink](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

#### Ruby

| Parameters        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay_payments` | Added  | [Account::Capability](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [Account::CreateParams::Capability](/api/accounts/create?api-version=2025-09-30.preview#create_account-capabilities), [Account::UpdateParams::Capability](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `paypay`          | Added  | [Charge::PaymentMethodDetail](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken::CreateParams::PaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [ConfirmationToken::PaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [PaymentAttemptRecord::PaymentMethodDetail](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent::ConfirmParams::PaymentMethodDatum](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntent::ConfirmParams::PaymentMethodOption](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntent::CreateParams::PaymentMethodDatum](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntent::CreateParams::PaymentMethodOption](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentIntent::PaymentMethodOption](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentIntent::UpdateParams::PaymentMethodDatum](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_data), [PaymentIntent::UpdateParams::PaymentMethodOption](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethod::CreateParams](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration::CreateParams](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfiguration::UpdateParams](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentRecord::PaymentMethodDetail](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntent::ConfirmParams::PaymentMethodDatum](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntent::CreateParams::PaymentMethodDatum](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data), [SetupIntent::UpdateParams::PaymentMethodDatum](/api/setup_intents/update?api-version=2025-09-30.preview#update_setup_intent-payment_method_data) |

#### Python

| Parameters        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay_payments` | Added  | [Account.Capability](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [Account.CreateParamsCapability](/api/accounts/create?api-version=2025-09-30.preview#create_account-capabilities), [Account.ModifyParamsCapability](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `paypay`          | Added  | [Charge.PaymentMethodDetail](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken.CreateParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [ConfirmationToken.PaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [PaymentAttemptRecord.PaymentMethodDetail](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent.ConfirmParamsPaymentMethodDatum](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntent.ConfirmParamsPaymentMethodOption](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntent.CreateParamsPaymentMethodDatum](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntent.CreateParamsPaymentMethodOption](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentIntent.ModifyParamsPaymentMethodDatum](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_data), [PaymentIntent.ModifyParamsPaymentMethodOption](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_options), [PaymentIntent.PaymentMethodOption](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethod.CreateParams](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration.CreateParams](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfiguration.ModifyParams](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentRecord.PaymentMethodDetail](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntent.ConfirmParamsPaymentMethodDatum](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntent.CreateParamsPaymentMethodDatum](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data), [SetupIntent.ModifyParamsPaymentMethodDatum](/api/setup_intents/update?api-version=2025-09-30.preview#update_setup_intent-payment_method_data) |

| Values   | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay` | Added  | [checkout.Session.CreateParams](/api/checkout/sessions/create?api-version=2025-09-30.preview#create_checkout_session-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `paypay` | Added  | [ConfirmationToken.CreateParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntent.CreateParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntent.ModifyParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntent.ConfirmParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntent.CreateParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntent.ModifyParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntent.ConfirmParamsPaymentMethodDatum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type) |
| `paypay` | Added  | [ConfirmationToken.PaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview-type), [PaymentMethod](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `paypay` | Added  | [Customer.ListPaymentMethodsParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethod.ListParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethod.CreateParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `paypay` | Added  | [PaymentIntent.CreateParams](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excluded_payment_method_types), [PaymentIntent](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excluded_payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `paypay` | Added  | [PaymentLink.CreateParams](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types), [PaymentLink.ModifyParams](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types), [PaymentLink](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

#### PHP

| Parameters        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay_payments` | Added  | [Account.capabilities](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [Account.create().$params.capability](/api/accounts/create?api-version=2025-09-30.preview#create_account-capabilities), [Account.update().$params.capability](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `paypay`          | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken.create().$params.payment_method_datum](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [PaymentAttemptRecord.payment_method_details](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent.confirm().$params.payment_method_datum](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntent.confirm().$params.payment_method_option](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntent.create().$params.payment_method_datum](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntent.create().$params.payment_method_option](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentIntent.update().$params.payment_method_datum](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_data), [PaymentIntent.update().$params.payment_method_option](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethod.create().$params](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration.create().$params](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfiguration.update().$params](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentRecord.payment_method_details](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntent.confirm().$params.payment_method_datum](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntent.create().$params.payment_method_datum](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data), [SetupIntent.update().$params.payment_method_datum](/api/setup_intents/update?api-version=2025-09-30.preview#update_setup_intent-payment_method_data) |

| Values   | Change | Enums                                                                                                                                                                                                                                                                            |
| -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay` | Added  | [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview-type), [PaymentMethod](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-type) |
| `paypay` | Added  | [PaymentIntent](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-excluded_payment_method_types)                                                                                                                                                  |
| `paypay` | Added  | [PaymentLink](/api/payment-link/object?api-version=2025-09-30.preview#payment_link_object-payment_method_types)                                                                                                                                                                  |

#### Java

| Parameters       | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypayPayments` | Added  | [Account.capabilities](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [AccountCreateParams.capabilities](/api/accounts/create?api-version=2025-09-30.preview#create_account-capabilities), [AccountUpdateParams.capabilities](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `paypay`         | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [PaymentAttemptRecord.payment_method_details](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfigurationCreateParams](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfigurationUpdateParams](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentRecord.payment_method_details](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2025-09-30.preview#update_setup_intent-payment_method_data) |

| Values   | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay` | Added  | [checkout.SessionCreateParams](/api/checkout/sessions/create?api-version=2025-09-30.preview#create_checkout_session-paymentMethodTypes)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `paypay` | Added  | [ConfirmationTokenCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntentCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntentUpdateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntentConfirmParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntentCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntentUpdateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntentConfirmParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type) |
| `paypay` | Added  | [CustomerListPaymentMethodsParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethodListParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethodCreateParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `paypay` | Added  | [PaymentIntentCreateParams](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excludedPaymentMethodTypes)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `paypay` | Added  | [PaymentLinkCreateParams](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-paymentMethodTypes), [PaymentLinkUpdateParams](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-paymentMethodTypes)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

#### Node.js

| Parameters        | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay_payments` | Added  | [Account.capabilities](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [AccountCreateParams.capabilities](/api/accounts/create?api-version=2025-09-30.preview#create_account-capabilities), [AccountUpdateParams.capabilities](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `paypay`          | Added  | [Charge.payment_method_details](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [ConfirmationTokenCreateParams.testHelpers.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [PaymentAttemptRecord.payment_method_details](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent.payment_method_options](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentIntentConfirmParams.payment_method_data](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmParams.payment_method_options](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntentCreateParams.payment_method_data](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntentCreateParams.payment_method_options](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentIntentUpdateParams.payment_method_data](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_data), [PaymentIntentUpdateParams.payment_method_options](/api/payment_intents/update?api-version=2025-09-30.preview#update_payment_intent-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfigurationCreateParams](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfigurationUpdateParams](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentMethodCreateParams](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentRecord.payment_method_details](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntentConfirmParams.payment_method_data](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntentCreateParams.payment_method_data](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data), [SetupIntentUpdateParams.payment_method_data](/api/setup_intents/update?api-version=2025-09-30.preview#update_setup_intent-payment_method_data) |

| Values   | Change | Enums                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay` | Added  | [Checkout.SessionCreateParams](/api/checkout/sessions/create?api-version=2025-09-30.preview#create_checkout_session-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `paypay` | Added  | [ConfirmationTokenCreateParams.testHelpers.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntentCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntentUpdateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [PaymentIntentConfirmParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntentCreateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntentUpdateParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type), [SetupIntentConfirmParams.payment_method_data](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data-type) |
| `paypay` | Added  | [ConfirmationToken.payment_method_preview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview-type), [PaymentMethod](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `paypay` | Added  | [CustomerListPaymentMethodsParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethodListParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type), [PaymentMethodCreateParams](/api/payment_methods/customer_list?api-version=2025-09-30.preview#list_payment_methods-type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `paypay` | Added  | [PaymentIntentCreateParams](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excluded_payment_method_types), [PaymentIntent](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-excluded_payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `paypay` | Added  | [PaymentLinkCreateParams](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types), [PaymentLinkUpdateParams](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types), [PaymentLink](/api/payment-link/create?api-version=2025-09-30.preview#create_payment_link-payment_method_types)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

#### Go

| Parameters       | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `PaypayPayments` | Added  | [AccountCapabilities](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [AccountCapabilitiesParams](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `Paypay`         | Added  | [ChargePaymentMethodDetails](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationTokenPaymentMethodDataParams](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [PaymentAttemptRecordPaymentMethodDetails](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntentConfirmPaymentMethodDataParams](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_data), [PaymentIntentConfirmPaymentMethodOptionsParams](/api/payment_intents/confirm?api-version=2025-09-30.preview#confirm_payment_intent-payment_method_options), [PaymentIntentPaymentMethodDataParams](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptions](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentIntentPaymentMethodOptionsParams](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfigurationParams](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodParams](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentRecordPaymentMethodDetails](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntentConfirmPaymentMethodDataParams](/api/setup_intents/confirm?api-version=2025-09-30.preview#confirm_setup_intent-payment_method_data), [SetupIntentPaymentMethodDataParams](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data) |

| Values   | Change | Enums                                                                                                                                                                                                                                                                         |
| -------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `paypay` | Added  | [ConfirmationTokenPaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview-Type), [PaymentMethod](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-Type) |
| `paypay` | Added  | [PaymentIntent](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-ExcludedPaymentMethodTypes)                                                                                                                                                  |
| `paypay` | Added  | [PaymentLink](/api/payment-link/object?api-version=2025-09-30.preview#payment_link_object-PaymentMethodTypes)                                                                                                                                                                 |

#### .NET

| Parameters       | Change | Resources or methods                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PaypayPayments` | Added  | [Account.Capabilities](/api/accounts/object?api-version=2025-09-30.preview#account_object-capabilities), [AccountCapabilitiesOptions](/api/accounts/update?api-version=2025-09-30.preview#update_account-capabilities)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `Paypay`         | Added  | [Charge.PaymentMethodDetails](/api/charges/object?api-version=2025-09-30.preview#charge_object-payment_method_details), [ConfirmationToken.PaymentMethodPreview](/api/confirmation_tokens/object?api-version=2025-09-30.preview#confirmation_token_object-payment_method_preview), [ConfirmationTokenPaymentMethodDataOptions](/api/confirmation_tokens/test_create?api-version=2025-09-30.preview#create_confirmation_token-payment_method_data), [PaymentAttemptRecord.PaymentMethodDetails](/api/payment-attempt-record/object?api-version=2025-09-30.preview#payment_attempt_record_object-payment_method_details), [PaymentIntent.PaymentMethodOptions](/api/payment_intents/object?api-version=2025-09-30.preview#payment_intent_object-payment_method_options), [PaymentIntentPaymentMethodDataOptions](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_data), [PaymentIntentPaymentMethodOptionsOptions](/api/payment_intents/create?api-version=2025-09-30.preview#create_payment_intent-payment_method_options), [PaymentMethod](/api/payment_methods/object?api-version=2025-09-30.preview), [PaymentMethodConfiguration](/api/payment_method_configurations/object?api-version=2025-09-30.preview), [PaymentMethodConfigurationCreateOptions](/api/payment_method_configurations/create?api-version=2025-09-30.preview#create_payment_method_configuration), [PaymentMethodConfigurationUpdateOptions](/api/payment_method_configurations/update?api-version=2025-09-30.preview#update_payment_method_configuration), [PaymentMethodCreateOptions](/api/payment_methods/create?api-version=2025-09-30.preview), [PaymentRecord.PaymentMethodDetails](/api/payment-record/object?api-version=2025-09-30.preview#payment_record_object-payment_method_details), [SetupIntentPaymentMethodDataOptions](/api/setup_intents/create?api-version=2025-09-30.preview#create_setup_intent-payment_method_data) |

## 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: 2025-09-30.preview`
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 [v16.1.0-beta.1](https://github.com/stripe/stripe-ruby/releases/tag/v16.1.0-beta.1)
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 [v13.1.2b1](https://github.com/stripe/stripe-python/releases/tag/v13.1.2b1)
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 [v18.1.0-beta.1](https://github.com/stripe/stripe-php/releases/tag/v18.1.0-beta.1)
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 [v30.1.0-beta.1](https://github.com/stripe/stripe-java/releases/tag/v30.1.0-beta.1)
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 [v19.2.0-beta.1](https://github.com/stripe/stripe-node/releases/tag/v19.2.0-beta.1)
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 [v83.1.0-beta.1](https://github.com/stripe/stripe-go/releases/tag/v83.1.0-beta.1)
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 [v49.1.0-beta.1](https://github.com/stripe/stripe-dotnet/releases/tag/v49.1.0-beta.1)
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

- [Restructures Smart Disputes recommended evidence field](https://docs.stripe.com/changelog/clover/2025-09-30/restructure-smart-disputes-recommended-evidence.md)
- [Adds the ability to choose how you submit a dispute response](https://docs.stripe.com/changelog/clover/2025-09-30/dispute-submission-method.md)
- [Adds Outbound Setup Intents to create usable payout methods](https://docs.stripe.com/changelog/clover/2025-09-30/outbound-setup-intents.md)
