サブスクリプションプランの変更を確定する前に、その影響をプレビューします。実際の変更を行うことなく、即時の請求額と新しいサブスクリプションの詳細を返します。
discount_codeを含めることができます。
/ LOCKED_PATTERN_07427f62e4e59df6149fbd24d60de439 */
| フィールド | 説明 |
|---|---|
immediate_charge | 行項目とサマリーを含め、即時に作成される料金 |
new_plan | プラン変更後の状態を示す完全なサブスクリプションオブジェクト |
immediate_charge.summaryは請求される合計金額を含みます。顧客がプラン変更を確認する前に価格を表示するために使用してください。
/ LOCKED_PATTERN_4dec52ce04aa8849a8a60508baae30ae */Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Subscription Id
Unique identifier of the product to subscribe to
Proration Billing Mode
prorated_immediately, full_immediately, difference_immediately, do_not_bill Number of units to subscribe for. Must be at least 1.
x >= 0Addons for the new plan. Note : Leaving this empty would remove any existing addons
Optional discount code to apply to the new plan.
If provided, validates and applies the discount to the plan change.
If not provided and the subscription has an existing discount with preserve_on_plan_change=true,
the existing discount will be preserved (if applicable to the new product).
When to apply the plan change.
immediately (default): Apply the plan change right awaynext_billing_date: Schedule the change for the next billing dateimmediately, next_billing_date Metadata for the payment. If not passed, the metadata of the subscription will be taken
Controls behavior when the plan change payment fails.
prevent_change: Keep subscription on current plan until payment succeedsapply_change (default): Apply plan change immediately regardless of payment outcomeIf not specified, uses the business-level default setting.
prevent_change, apply_change