# Alma、Amazon Pay、Billie、Satispay、韓国の決済手段で使用される支払いの失敗コードのセットを変更します。

## 新機能

支払い方法が拒否された理由を通知する、より詳細な支払いの失敗コードを追加します。

## 影響

[PaymentIntents](https://docs.stripe.com/api/payment_intents.md?api-version=2025-09-30.preview) の更新された [拒否コード](https://docs.stripe.com/declines/codes.md) は、[last_payment_error.decline_code](https://docs.stripe.com/api/payment_intents/object.md?api-version=2025-09-30.preview#payment_intent_object-last_payment_error-decline_code) フィールドに記録されます。拒否の理由は、ダッシュボードの [取引](https://dashboard.stripe.com/test/payments) ページでも確認できます。統合がこのフィールドに依存している場合は、それに応じて統合を更新する必要があります。

## アップグレード

#### 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-09-30.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 を [v16.0.0](https://github.com/stripe/stripe-ruby/releases/tag/v16.0.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.0.1](https://github.com/stripe/stripe-python/releases/tag/v13.0.1)にアップグレードします。
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.0.0](https://github.com/stripe/stripe-php/releases/tag/v18.0.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.0.0](https://github.com/stripe/stripe-java/releases/tag/v30.0.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.1.0](https://github.com/stripe/stripe-node/releases/tag/v19.1.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.0.0](https://github.com/stripe/stripe-go/releases/tag/v83.0.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.0.0](https://github.com/stripe/stripe-dotnet/releases/tag/v49.0.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)について、詳細をご確認ください。

## 関連する変更

- [送信されたステーブルコイン決済に処理ステータスを追加](https://docs.stripe.com/changelog/clover/2025-09-30/stablecoin-payments-processing-status.md)
- [Klarna チャージバックによる損失の理由を文書化して Disputes API に追加](https://docs.stripe.com/changelog/clover/2025-09-30/chargeback-loss-reason.md)
- [MB WAY 決済手段のサポートを追加](https://docs.stripe.com/changelog/clover/2025-09-30/mb-way-payments.md)