# 支払いにアドバイスコードを追加する ## 新機能 [advice_code](https://docs.stripe.com/api/charges/object.md?api-version=2025-01-27.acacia#charge_object-outcome-advice_code) プロパティを[支払い](https://docs.stripe.com/api/charges/object.md?api-version=2025-01-27.acacia)オブジェクトに追加します。 `advice_code` は、失敗したトランザクションに関する詳細を示す列挙値です。 ## 影響 この `advice_code` を使用して、取引が失敗した場合の[エラーの処理方法](https://docs.stripe.com/declines.md#issuer-declines)を把握できます。 ## 変更点 #### REST API | Parameters | Change | Resources or endpoints | | ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `advice_code` | Added | [Charge.outcome](/api/charges/object?api-version=2025-01-27.acacia#charge_object-outcome) | | `advice_code` | Added | [Invoice.last_finalization_error](/api/invoices/object?api-version=2025-01-27.acacia#invoice_object-last_finalization_error), [PaymentIntent.last_payment_error](/api/payment_intents/object?api-version=2025-01-27.acacia#payment_intent_object-last_payment_error), [SetupAttempt.setup_error](/api/setup_attempts/object?api-version=2025-01-27.acacia#setup_attempt_object-setup_error), [SetupIntent.last_setup_error](/api/setup_intents/object?api-version=2025-01-27.acacia#setup_intent_object-last_setup_error), [StripeError](/api/errors?api-version=2025-01-27.acacia) | #### Ruby この変更は、Ruby SDK には影響しません。 #### Python | Parameters | Change | Resources or methods | | ------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `advice_code` | Added | [stripe.Charge.Outcome](/api/charges/object?api-version=2025-01-27.acacia#charge_object-outcome) | | `advice_code` | Added | [stripe.Invoice.LastFinalizationError](/api/invoices/object?api-version=2025-01-27.acacia#invoice_object-last_finalization_error), [stripe.PaymentIntent.LastPaymentError](/api/payment_intents/object?api-version=2025-01-27.acacia#payment_intent_object-last_payment_error), [stripe.SetupAttempt.SetupError](/api/setup_attempts/object?api-version=2025-01-27.acacia#setup_attempt_object-setup_error), [stripe.SetupIntent.LastSetupError](/api/setup_intents/object?api-version=2025-01-27.acacia#setup_intent_object-last_setup_error) | #### PHP | Parameter | Change | Resources or methods | | ------------- | ------ | -------------------------------------------------------- | | `advice_code` | Added | [StripeError](/api/errors?api-version=2025-01-27.acacia) | #### Java | Parameters | Change | Resources or methods | | ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `advice_code` | Added | [Charge.outcome](/api/charges/object?api-version=2025-01-27.acacia#charge_object-outcome) | | `advice_code` | Added | [Invoice.last_finalization_error](/api/invoices/object?api-version=2025-01-27.acacia#invoice_object-last_finalization_error), [PaymentIntent.last_payment_error](/api/payment_intents/object?api-version=2025-01-27.acacia#payment_intent_object-last_payment_error), [SetupAttempt.setup_error](/api/setup_attempts/object?api-version=2025-01-27.acacia#setup_attempt_object-setup_error), [SetupIntent.last_setup_error](/api/setup_intents/object?api-version=2025-01-27.acacia#setup_intent_object-last_setup_error), [StripeError](/api/errors?api-version=2025-01-27.acacia) | #### Node.js | Parameters | Change | Resources or methods | | ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `advice_code` | Added | [Charge.outcome](/api/charges/object?api-version=2025-01-27.acacia#charge_object-outcome) | | `advice_code` | Added | [Invoice.last_finalization_error](/api/invoices/object?api-version=2025-01-27.acacia#invoice_object-last_finalization_error), [PaymentIntent.last_payment_error](/api/payment_intents/object?api-version=2025-01-27.acacia#payment_intent_object-last_payment_error), [SetupAttempt.setup_error](/api/setup_attempts/object?api-version=2025-01-27.acacia#setup_attempt_object-setup_error), [SetupIntent.last_setup_error](/api/setup_intents/object?api-version=2025-01-27.acacia#setup_intent_object-last_setup_error), [StripeError](/api/errors?api-version=2025-01-27.acacia) | #### Go | Parameters | Change | Resources or methods | | ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `AdviceCode` | Added | [ChargeOutcome](/api/charges/object?api-version=2025-01-27.acacia#charge_object-outcome) | | `AdviceCode` | Added | [InvoiceLastFinalizationError](/api/invoices/object?api-version=2025-01-27.acacia#invoice_object-last_finalization_error), [PaymentIntentLastPaymentError](/api/payment_intents/object?api-version=2025-01-27.acacia#payment_intent_object-last_payment_error), [SetupAttemptSetupError](/api/setup_attempts/object?api-version=2025-01-27.acacia#setup_attempt_object-setup_error), [SetupIntentLastSetupError](/api/setup_intents/object?api-version=2025-01-27.acacia#setup_intent_object-last_setup_error), [StripeError](/api/errors?api-version=2025-01-27.acacia) | #### .NET | Parameters | Change | Resources or methods | | ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `AdviceCode` | Added | [ChargeOutcome](/api/charges/object?api-version=2025-01-27.acacia#charge_object-outcome) | | `AdviceCode` | Added | [InvoiceLastFinalizationError](/api/invoices/object?api-version=2025-01-27.acacia#invoice_object-last_finalization_error), [PaymentIntentLastPaymentError](/api/payment_intents/object?api-version=2025-01-27.acacia#payment_intent_object-last_payment_error), [SetupAttemptSetupError](/api/setup_attempts/object?api-version=2025-01-27.acacia#setup_attempt_object-setup_error), [SetupIntentLastSetupError](/api/setup_intents/object?api-version=2025-01-27.acacia#setup_intent_object-last_setup_error), [StripeError](/api/errors?api-version=2025-01-27.acacia) | ## アップグレード #### 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-01-27.acacia` を含めるように [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 を [v13.4.0](https://github.com/stripe/stripe-ruby/releases/tag/v13.4.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 を [v11.5.0](https://github.com/stripe/stripe-python/releases/tag/v11.5.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 を [v16.5.0](https://github.com/stripe/stripe-php/releases/tag/v16.5.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 を [v28.3.0](https://github.com/stripe/stripe-java/releases/tag/v28.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)について、詳細をご確認ください。 #### 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 を [v17.6.0](https://github.com/stripe/stripe-node/releases/tag/v17.6.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 を [v81.3.0](https://github.com/stripe/stripe-go/releases/tag/v81.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)について、詳細をご確認ください。 #### .NET 1. Workbench で[現在の API バージョンを表示します](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench)。 1. .NET SDK を [v47.3.0](https://github.com/stripe/stripe-dotnet/releases/tag/v47.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)について、詳細をご確認ください。