# 金額確認のパラメーターを Payment Intent API に追加

## 新機能

シークレットキー発信者の [amount_to_confirm](https://docs.stripe.com/api/payment_intents/confirm.md?api-version=2026-04-22.dahlia#confirm_payment_intent-amount_to_confirm) パラメーターを [Payment Intents](https://docs.stripe.com/api/payment_intents.md?api-version=2026-04-22.dahlia) API に追加します。このパラメーターを使用すると、PaymentIntent で確定する正確な金額が指定できます。金額を指定しない場合、パラメーターのデフォルトはその PaymentIntent の [amount](https://docs.stripe.com/api/payment_intents/object.md?api-version=2026-04-22.dahlia#payment_intent_object-amount) 値になります。

## 新機能の影響

元の金額と異なる金額で PaymentIntents を確定する必要がある組み込みを構築する際に、`amount_to_confirm` パラメーターが参照できるようになりました。たとえば、PaymentIntents を確定する際に[元の金額に追加料金を含める](https://docs.stripe.com/payments/cards/surcharge.md#confirm-the-payment-with-a-surcharge)ことができます。

## 変更点

#### REST API

| Parameter | Change | Resources or endpoints |
| --- | --- | --- |
| `amount_to_confirm` | Added | [PaymentIntent#confirm](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### Ruby

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `amount_to_confirm` | Added | [PaymentIntentConfirmParams](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### Python

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `amount_to_confirm` | Added | [PaymentIntentConfirmParams](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### PHP

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `amount_to_confirm` | Added | [PaymentIntent.confirm().$params](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### Java

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `amountToConfirm` | Added | [PaymentIntentConfirmParams](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### Node.js

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `amount_to_confirm` | Added | [PaymentIntentConfirmParams](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### Go

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `AmountToConfirm` | Added | [PaymentIntentConfirmParams](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

#### .NET

| Parameter | Change | Resources or methods |
| --- | --- | --- |
| `AmountToConfirm` | Added | [PaymentIntentConfirmOptions](/api/payment_intents/confirm?api-version=2026-04-22.dahlia#confirm_payment_intent) |

## アップグレード

#### REST API

1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。
2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
   - SDK を使用していない場合は、`Stripe-Version: 2026-04-22.dahlia` を含めるように [API リクエスト](https://docs.stripe.com/api/versioning.md)を更新してください。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. Ruby SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. Python SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. PHP SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. Java SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. Node SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. Go SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)。
2. .NET SDK を 最新バージョンにアップグレードします。
3. [Webhook エンドポイント](https://docs.stripe.com/webhooks/versioning.md)に使用する API バージョンをアップグレードします。
4. 新しいバージョンに対して、[実装内容をテスト](https://docs.stripe.com/testing.md)します。
5. Connect を使用する場合は、[Connect の実装内容をテスト](https://docs.stripe.com/connect/testing.md)します。
6. 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)について、詳細をご確認ください。

## 関連する変更

- [後払いの決済手段である Sunbit への対応を追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/sunbit-buy-now-pay-later-support.md)
- [Pix の継続課金への対応を追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/pix-recurring-payments-support.md)
- [カードの Setup Attempt の決済手段詳細に moto プロパティを追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/setup-attempt-payment-method-details-for-cards-moto.md)
- [端末リーダーでの Klarna 決済の QR コード対応を追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/klarna-payments-with-terminal-readers-qr-code-support.md)
- [Stripe のマーチャントオブレコードソリューションである Managed Payments への対応を追加](https://docs.stripe.com/changelog/dahlia/2026-04-22/managed-payments.md)