更新の保留の参照情報
更新の保留機能の詳細については以下をご覧ください。
サポートされる属性![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
更新の保留の作成には、特定の属性のみを使用できます。これらの属性は、比例配分 (日割り / 秒割り計算) の動作をコントロールするか、新しい請求書を作成します。
以下は、update subscription (サブスクリプションの更新) エンドポイントでサポートされる属性です。
expand
payment_
behavior proration_
behavior proration_
date billing_
cycle_ anchor items
price
quantity
trial_
end trial_
from_ plan add_
invoice_ items
以下は、create subscription item (サブスクリプションの作成) エンドポイントおよび update subscription item (サブスクリプションの更新) エンドポイントでサポートされる属性です。
expand
payment_
behavior proration_
behavior proration_
date price
quantity
更新の保留のライフサイクル![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
支払いが成功すると、請求書は paid
に更新され、その変更は直ちにサブスクリプション に適用されます。支払いが失敗すると、更新された値が Subscription
オブジェクトの pending_
ハッシュに追加されます。サブスクリプションの latest_
とは、 open
ステータスの未払いの請求書を指します。更新リクエストが行われなかったかのように、サブスクリプションはサイクルを続行します。
支払いの失敗を処理する方法は 2 通りあります。これらは、支払い拒否と顧客認証に関係します。これらの問題を解決したら、再度支払いが試行されます。支払いが完了すると変更が適用され、pending_
ハッシュがクリアされます。支払いが再び失敗した場合には、元の期日とともに pending_
ハッシュがサブスクリプションに残り、いずれの変更も適用されません。
更新の保留をキャンセルすると、pending_
ハッシュがクリアされ、関連付けられている変更が破棄されます。
有効期限![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
更新が失敗した後にアクションを実行しなかった場合、請求書は無効になり、pending_
の expired_
の経過後に更新の保留が破棄されます。この期限は、trial end (トライアルの終了) または current period end (現期間の終了) のうち、いずれか早い方に設定されます。これらの時間が、更新が行われる時間から 23 時間以上後の場合は、expired_
の日時は更新コールが行われてから 23 時間後に計算されます。
さらに以下のいずれかが発生した場合には、 Stripe は請求書を自動的に無効化し、更新の保留を削除します。
- サブスクリプションが請求のしきい値に達した。
- サブスクリプションにリンクされたサブスクリプションのスケジュールが新しいフェーズに移行した。
更新の保留イベント![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Webhook を使用して、更新の保留に関する以下のイベントをリッスンできます。
イベント | 目的 |
---|---|
customer. | サブスクリプションの通知を受け取ります。pending_ ハッシュを確認し、必要に応じて支払いの失敗を解決します。 |
customer. | 保留中の更新が適用された場合に通知を受け取り、サービスのアップグレード、ダウングレード、プロビジョニング、デプロビジョニングなどの追加アクションを実行できるようにします。 |
customer. | 更新の保留の期限が切れたり、自動的に無効化されると通知を受け取ります。必要に応じて、更新リクエストを再試行してください。 |
更新の保留とサブスクリプションのスケジュール![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
更新の保留とサブスクリプションスケジュールの両方をサブスクリプションの管理に使用できます。スケジュールのフェーズが変化するときに保留中の更新がある場合には、そのフェーズ移行が発生する前に、その保留中の更新は破棄され、関連する請求書が無効化されます。必要に応じて、フェーズ移行後に更新リクエストを再試行することができます。
使用状況の記録![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
サブスクリプションに従量ベースのアイテムが含まれる場合、Stripe は保留中の更新請求書で未払いの使用状況記録に対する請求を行います。ただし、保留中の更新の支払いが有効期限前に発生しない場合、Stripe はこれらの使用状況の記録を破棄し、次の請求書で請求されないようにします。さらに、保留中の更新によって従量料金が削除された場合、Stripe は保留中の更新の作成とその結果生じる請求書の支払いの間に報告された使用量をすべて無視し、すべての請求書から除外します。