# Payment Intents で対面カード決済をキャプチャーする方法を指定する機能を追加 ## 新機能 [Payment Intents](https://docs.stripe.com/api/payment_intents.md?api-version=2025-11-17.clover) を使用した対面カード決済の [payment_method_options](https://docs.stripe.com/api/payment_intents/object.md?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present-capture_method) に [capture_method](https://docs.stripe.com/api/payment_intents/object.md?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present-capture_method) を指定する機能を追加しました。 必要に応じて、キャプチャーする方法を次のいずれかの値に設定できます。 - `manual` は、資金を保留にし、オーソリ後に決済を明示的にキャプチャーするように Stripe に指示します。たとえば、注文のフルフィルメントが完了するまで待ってから資金をキャプチャーする場合があります。 - `manual_preferred` は、Stripe が `manual` キャプチャーを優先するよう Stripe に指示しますが、提示されたカードの対応ネットワークに基づいて、適切な場合は `automatic` 動作を使用します。これにより、可能な場合は手動キャプチャーがサポートされ、不可能な場合でも拒否されません。 ## 影響 Payment Intents の対面カード決済をキャプチャーする動作を指定できるようになりました。`capture_method` は、顧客のアカウントから資金をキャプチャーするタイミングを制御します。 ## 変更点 #### REST API | Parameter | Change | Resources or endpoints | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `capture_method` | Added | [PaymentIntent#confirm.payment_method_options.card_present](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntent#create.payment_method_options.card_present](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present), [PaymentIntent#update.payment_method_options.card_present](/api/payment_intents/update?api-version=2025-11-17.clover#update_payment_intent-payment_method_options-card_present), [PaymentIntent.payment_method_options.card_present](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present) | #### Ruby | Parameter | Change | Resources or methods | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `capture_method` | Added | [PaymentIntent::PaymentMethodOption::CardPresent](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntentConfirmParams::PaymentMethodOption::CardPresent](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntentCreateParams::PaymentMethodOption::CardPresent](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present), [PaymentIntentUpdateParams::PaymentMethodOption::CardPresent](/api/payment_intents/update?api-version=2025-11-17.clover#update_payment_intent-payment_method_options-card_present) | #### Python | Parameter | Change | Resources or methods | | ---------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `capture_method` | Added | [PaymentIntent.PaymentMethodOption.CardPresent](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntentConfirmParamsPaymentMethodOptionCardPresent](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntentCreateParamsPaymentMethodOptionCardPresent](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present), [PaymentIntentModifyParamsPaymentMethodOptionCardPresent](/api/payment_intents/update?api-version=2025-11-17.clover#update_payment_intent-payment_method_options-card_present) | #### PHP | Parameter | Change | Resources or methods | | ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `capture_method` | Added | [PaymentIntent.confirm().$params.payment_method_option.card_present](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntent.create().$params.payment_method_option.card_present](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present), [PaymentIntent.payment_method_options.card_present](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntent.update().$params.payment_method_option.card_present](/api/payment_intents/update?api-version=2025-11-17.clover#update_payment_intent-payment_method_options-card_present) | #### Java | Parameter | Change | Resources or methods | | --------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `captureMethod` | Added | [PaymentIntent.payment_method_options.card_present](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntentConfirmParams.payment_method_options.card_present](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntentCreateParams.payment_method_options.card_present](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present), [PaymentIntentUpdateParams.payment_method_options.card_present](/api/payment_intents/update?api-version=2025-11-17.clover#update_payment_intent-payment_method_options-card_present) | #### Node.js | Parameter | Change | Resources or methods | | ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `capture_method` | Added | [PaymentIntent.payment_method_options.card_present](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntentConfirmParams.payment_method_options.card_present](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntentCreateParams.payment_method_options.card_present](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present), [PaymentIntentUpdateParams.payment_method_options.card_present](/api/payment_intents/update?api-version=2025-11-17.clover#update_payment_intent-payment_method_options-card_present) | #### Go | Parameter | Change | Resources or methods | | --------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CaptureMethod` | Added | [PaymentIntentConfirmPaymentMethodOptionsCardPresentParams](/api/payment_intents/confirm?api-version=2025-11-17.clover#confirm_payment_intent-payment_method_options-card_present), [PaymentIntentPaymentMethodOptionsCardPresent](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntentPaymentMethodOptionsCardPresentParams](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present) | #### .NET | Parameter | Change | Resources or methods | | --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CaptureMethod` | Added | [PaymentIntent.PaymentMethodOptions.CardPresent](/api/payment_intents/object?api-version=2025-11-17.clover#payment_intent_object-payment_method_options-card_present), [PaymentIntentPaymentMethodOptionsCardPresentOptions](/api/payment_intents/create?api-version=2025-11-17.clover#create_payment_intent-payment_method_options-card_present) | ## アップグレード #### REST API 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。 - SDK を使用していない場合は、`Stripe-Version: 2025-11-17.clover` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Ruby 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Ruby SDK を [v17.2.0](https://github.com/stripe/stripe-ruby/releases/tag/v17.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Python 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Python SDK を [v13.2.0](https://github.com/stripe/stripe-python/releases/tag/v13.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### PHP 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. PHP SDK を [v18.2.0](https://github.com/stripe/stripe-php/releases/tag/v18.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Java 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Java SDK を [v30.2.0](https://github.com/stripe/stripe-java/releases/tag/v30.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Node.js 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Node SDK を [v19.3.0](https://github.com/stripe/stripe-node/releases/tag/v19.3.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### Go 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. Go SDK を [v83.2.0](https://github.com/stripe/stripe-go/releases/tag/v83.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 #### .NET 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. .NET SDK を [v49.2.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.2.0)にアップグレードします。 1. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。 1. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。 1. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。 1. Workbench で[アップグレードを実行](https://docs.stripe.com/upgrades.md#perform-the-upgrade)します。[バージョンをロールバック](https://docs.stripe.com/upgrades.md#roll-back-your-api-version)できるのは 72 時間以内です。 [Stripe API のアップグレード](https://docs.stripe.com/upgrades.md)について、詳細をご確認ください。 ## 関連する変更 - [取引 ID を iDEAL の決済手段の詳細に追加](https://docs.stripe.com/changelog/clover/2025-11-17/ideal-transaction-id.md) - [MB WAY と TWINT を返金先詳細に追加](https://docs.stripe.com/changelog/clover/2025-11-17/mb-way-twint-destination-details-for-refunds.md) - [Finom をサポートされている iDEAL の銀行として追加](https://docs.stripe.com/changelog/clover/2025-11-17/ideal-payments-finom.md)