コンテンツにスキップ

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

返金の保留理由を説明するフィールドを追加

新規情報

pending_reason フィールドを Refunds API に追加しました。新しいフィールドは返金の保留理由を説明し、次の値を返します。

processing:返金を処理中です。
insufficient_funds:Stripe アカウントの残高が不足しているため、この返金を充当できません。
charge_pending:返金対象の支払いはまだ売上処理されていません。

効果

refund の status が pending の場合、pending_reason フィールドを調べて理由を確認し、解決に必要なアクションを実行できます。

変更点

パラメーター	変更する	リソースまたはエンドポイント
pending_reason	追加済み	`Refund`

Upgrade

View your current API version in Workbench.
If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-04-30.basil
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.