# アメリカの銀行口座決済の PaymentIntent に取引目的を追加します ## 新機能 [transaction_purpose](https://docs.stripe.com/api/payment_intents/object.md?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account-transaction_purpose) パラメーターを [PaymentIntents](https://docs.stripe.com/api/payment_intents.md?api-version=2026-02-25.clover) API の[payment_method_options.us_bank_account](https://docs.stripe.com/api/payment_intents/object.md?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account) ハッシュに追加します。この任意のパラメーターにより、ACH デビット取引の目的を`商品`、`サービス`、`その他`、`不明`の中から選べるようになります。何も指定されない場合のこのパラメーターのデフォルト値は`不明`です。 ## 効果 PaymentIntents の作成・更新時に、アメリカの銀行口座からの支払いについて取引目的が指定できるようになりました。このパラメーターは任意ですが、正確な取引目的の情報を提供することは、ACH ネットワーク要件に準拠していることが確認できます。例えば Nacha 規則は、特定の ACH デビット取引を EC 購入であると明示するよう求めています。コンプライアンスを確保するために取引目的を指定する必要がない場合もあります。詳しくは [ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit.md) をご覧ください。 商品やサービスの ACH デビットによる支払いを処理する場合は、PaymentIntents を作成する際に、適切な `transaction_purpose` 値を含めるように構築済みの実装システムを更新することを検討してください。 ## 変更点 #### REST API | Parameter | Change | Resources or endpoints | | --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `transaction_purpose` | Added | [PaymentIntent#confirm.payment_method_options.us_bank_account](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntent#create.payment_method_options.us_bank_account](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account), [PaymentIntent#update.payment_method_options.us_bank_account](/api/payment_intents/update?api-version=2026-02-25.clover#update_payment_intent-payment_method_options-us_bank_account), [PaymentIntent.payment_method_options.us_bank_account](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account) | #### Ruby | Parameter | Change | Resources or methods | | --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `transaction_purpose` | Added | [PaymentIntent::PaymentMethodOption::UsBankAccount](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntentConfirmParams::PaymentMethodOption::UsBankAccount](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntentCreateParams::PaymentMethodOption::UsBankAccount](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account), [PaymentIntentUpdateParams::PaymentMethodOption::UsBankAccount](/api/payment_intents/update?api-version=2026-02-25.clover#update_payment_intent-payment_method_options-us_bank_account) | #### Python | Parameter | Change | Resources or methods | | --------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `transaction_purpose` | Added | [PaymentIntent.PaymentMethodOption.UsBankAccount](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account), [PaymentIntentModifyParamsPaymentMethodOptionUsBankAccount](/api/payment_intents/update?api-version=2026-02-25.clover#update_payment_intent-payment_method_options-us_bank_account) | #### PHP | Parameter | Change | Resources or methods | | --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `transaction_purpose` | Added | [PaymentIntent.confirm().$params.payment_method_option.us_bank_account](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntent.create().$params.payment_method_option.us_bank_account](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account), [PaymentIntent.payment_method_options.us_bank_account](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntent.update().$params.payment_method_option.us_bank_account](/api/payment_intents/update?api-version=2026-02-25.clover#update_payment_intent-payment_method_options-us_bank_account) | #### Java | Parameter | Change | Resources or methods | | -------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `transactionPurpose` | Added | [PaymentIntent.payment_method_options.us_bank_account](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntentConfirmParams.payment_method_options.us_bank_account](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntentCreateParams.payment_method_options.us_bank_account](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account), [PaymentIntentUpdateParams.payment_method_options.us_bank_account](/api/payment_intents/update?api-version=2026-02-25.clover#update_payment_intent-payment_method_options-us_bank_account) | #### Node.js | Parameter | Change | Resources or methods | | --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `transaction_purpose` | Added | [PaymentIntent.payment_method_options.us_bank_account](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntentConfirmParams.payment_method_options.us_bank_account](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntentCreateParams.payment_method_options.us_bank_account](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account), [PaymentIntentUpdateParams.payment_method_options.us_bank_account](/api/payment_intents/update?api-version=2026-02-25.clover#update_payment_intent-payment_method_options-us_bank_account) | #### Go | Parameter | Change | Resources or methods | | -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `TransactionPurpose` | Added | [PaymentIntentConfirmPaymentMethodOptionsUsBankAccountParams](/api/payment_intents/confirm?api-version=2026-02-25.clover#confirm_payment_intent-payment_method_options-us_bank_account), [PaymentIntentPaymentMethodOptionsUsBankAccount](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntentPaymentMethodOptionsUsBankAccountParams](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account) | #### .NET | Parameter | Change | Resources or methods | | -------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `TransactionPurpose` | Added | [PaymentIntent.PaymentMethodOptions.UsBankAccount](/api/payment_intents/object?api-version=2026-02-25.clover#payment_intent_object-payment_method_options-us_bank_account), [PaymentIntentPaymentMethodOptionsUsBankAccountOptions](/api/payment_intents/create?api-version=2026-02-25.clover#create_payment_intent-payment_method_options-us_bank_account) | ## アップグレード #### 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: 2026-02-25.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 を 最新バージョンにアップグレードします。 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 を 最新バージョンにアップグレードします。 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 を 最新バージョンにアップグレードします。 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 を 最新バージョンにアップグレードします。 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 を 最新バージョンにアップグレードします。 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 を 最新バージョンにアップグレードします。 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 を 最新バージョンにアップグレードします。 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)について、詳細をご確認ください。 ## 関連する変更 - [Bacs ダイレクトデビットの同意書に表示名とサービスユーザー番号を追加](https://docs.stripe.com/changelog/clover/2026-02-25/display-name-and-service-user-number.md) - [リザーブ保留、リリース、プランのイベントを追加](https://docs.stripe.com/changelog/clover/2026-02-25/reserve-holds-releases-plans-events.md) - [支払い記録の支払い方法詳細で Boleto の納税者番号を nullable に変更します](https://docs.stripe.com/changelog/clover/2026-02-25/makes-tax-id-field-nullable-in-boleto-payment-method-details.md)