Update a subscription
POST {{baseUrl}}/v1/subscriptions/:subscription_exposed_id
Updates an existing subscription on a customer to match the specified parameters. When changing plans or quantities, we will optionally prorate the price we charge next month to make up for any price changes. To preview how the proration will be calculated, use the upcoming invoice endpoint.
Request Body
[{"name"=>"add_invoice_items[0][price]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][price_data][currency]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][price_data][product]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][price_data][tax_behavior]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][price_data][unit_amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][price_data][unit_amount_decimal]", "value"=>"<decimal>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][quantity]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][tax_rates][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[0][tax_rates][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][price]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][price_data][currency]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][price_data][product]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][price_data][tax_behavior]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][price_data][unit_amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][price_data][unit_amount_decimal]", "value"=>"<decimal>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][quantity]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][tax_rates][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"add_invoice_items[1][tax_rates][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"application_fee_percent", "value"=>"<number>", "datatype"=>"string"}, {"name"=>"automatic_tax[enabled]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"billing_cycle_anchor", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"billing_thresholds[amount_gte]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"billing_thresholds[reset_billing_cycle_anchor]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"cancel_at_period_end", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"cancellation_details[comment]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"cancellation_details[feedback]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"collection_method", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"coupon", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"days_until_due", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"default_payment_method", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"default_source", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"default_tax_rates[0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"default_tax_rates[1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"description", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"expand[0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"expand[1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][billing_thresholds][usage_gte]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[0][clear_usage]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"items[0][deleted]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"items[0][id]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][metadata]", "value"=>"<object>", "datatype"=>"string"}, {"name"=>"items[0][price]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][price_data][currency]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][price_data][product]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][price_data][recurring][interval]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][price_data][recurring][interval_count]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[0][price_data][tax_behavior]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][price_data][unit_amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[0][price_data][unit_amount_decimal]", "value"=>"<decimal>", "datatype"=>"string"}, {"name"=>"items[0][quantity]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[0][tax_rates][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[0][tax_rates][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][billing_thresholds][usage_gte]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[1][clear_usage]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"items[1][deleted]", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"items[1][id]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][metadata]", "value"=>"<object>", "datatype"=>"string"}, {"name"=>"items[1][price]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][price_data][currency]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][price_data][product]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][price_data][recurring][interval]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][price_data][recurring][interval_count]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[1][price_data][tax_behavior]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][price_data][unit_amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[1][price_data][unit_amount_decimal]", "value"=>"<decimal>", "datatype"=>"string"}, {"name"=>"items[1][quantity]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"items[1][tax_rates][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"items[1][tax_rates][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"off_session", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"pause_collection[behavior]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"pause_collection[resumes_at]", "value"=>"<unix-time>", "datatype"=>"string"}, {"name"=>"payment_behavior", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][acss_debit][mandate_options][transaction_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][acss_debit][verification_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][bancontact][preferred_language]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][card][mandate_options][amount]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][card][mandate_options][amount_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][card][mandate_options][description]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][card][network]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][card][request_three_d_secure]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][customer_balance][bank_transfer][eu_bank_transfer][country]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][customer_balance][bank_transfer][type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][customer_balance][funding_type]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][us_bank_account][financial_connections][permissions][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][us_bank_account][financial_connections][permissions][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_options][us_bank_account][verification_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_types][0]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[payment_method_types][1]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"payment_settings[save_default_payment_method]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"pending_invoice_item_interval[interval]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"pending_invoice_item_interval[interval_count]", "value"=>"<integer>", "datatype"=>"string"}, {"name"=>"promotion_code", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"proration_behavior", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"proration_date", "value"=>"<unix-time>", "datatype"=>"string"}, {"name"=>"transfer_data[destination]", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"transfer_data[amount_percent]", "value"=>"<number>", "datatype"=>"string"}, {"name"=>"trial_from_plan", "value"=>"<boolean>", "datatype"=>"string"}, {"name"=>"trial_settings[end_behavior][missing_payment_method]", "value"=>"<string>", "datatype"=>"string"}]
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |