Package com.stripe.param

Class SubscriptionScheduleUpdateParams.Phase.Builder

java.lang.Object

com.stripe.param.SubscriptionScheduleUpdateParams.Phase.Builder

Enclosing class:

SubscriptionScheduleUpdateParams.Phase

public static class SubscriptionScheduleUpdateParams.Phase.Builder
extends Object

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
SubscriptionScheduleUpdateParams.Phase.Builder	addAddInvoiceItem(SubscriptionScheduleUpdateParams.Phase.AddInvoiceItem element)	Add an element to `addInvoiceItems` list.
SubscriptionScheduleUpdateParams.Phase.Builder	addAllAddInvoiceItem(List<SubscriptionScheduleUpdateParams.Phase.AddInvoiceItem> elements)	Add all elements to `addInvoiceItems` list.
SubscriptionScheduleUpdateParams.Phase.Builder	addAllDefaultTaxRate(List<String> elements)	Add all elements to `defaultTaxRates` list.
SubscriptionScheduleUpdateParams.Phase.Builder	addAllItem(List<SubscriptionScheduleUpdateParams.Phase.Item> elements)	Add all elements to `items` list.
SubscriptionScheduleUpdateParams.Phase.Builder	addDefaultTaxRate(String element)	Add an element to `defaultTaxRates` list.
SubscriptionScheduleUpdateParams.Phase.Builder	addItem(SubscriptionScheduleUpdateParams.Phase.Item element)	Add an element to `items` list.
SubscriptionScheduleUpdateParams.Phase	build()	Finalize and obtain parameter instance from this builder.
SubscriptionScheduleUpdateParams.Phase.Builder	putAllExtraParam(Map<String,Object> map)	Add all map key/value pairs to `extraParams` map.
SubscriptionScheduleUpdateParams.Phase.Builder	putAllMetadata(Map<String,String> map)	Add all map key/value pairs to `metadata` map.
SubscriptionScheduleUpdateParams.Phase.Builder	putExtraParam(String key, Object value)	Add a key/value pair to `extraParams` map.
SubscriptionScheduleUpdateParams.Phase.Builder	putMetadata(String key, String value)	Add a key/value pair to `metadata` map.
SubscriptionScheduleUpdateParams.Phase.Builder	setApplicationFeePercent(BigDecimal applicationFeePercent)	A non-negative decimal between 0 and 100, with at most two decimal places.
SubscriptionScheduleUpdateParams.Phase.Builder	setAutomaticTax(SubscriptionScheduleUpdateParams.Phase.AutomaticTax automaticTax)	Automatic tax settings for this phase.
SubscriptionScheduleUpdateParams.Phase.Builder	setBillingCycleAnchor(SubscriptionScheduleUpdateParams.Phase.BillingCycleAnchor billingCycleAnchor)	Can be set to phase_start to set the anchor to the start of the phase or automatic to automatically change it if needed.
SubscriptionScheduleUpdateParams.Phase.Builder	setBillingThresholds(EmptyParam billingThresholds)	Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period.
SubscriptionScheduleUpdateParams.Phase.Builder	setBillingThresholds(SubscriptionScheduleUpdateParams.Phase.BillingThresholds billingThresholds)	Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period.
SubscriptionScheduleUpdateParams.Phase.Builder	setCollectionMethod(SubscriptionScheduleUpdateParams.Phase.CollectionMethod collectionMethod)	Either charge_automatically, or send_invoice.
SubscriptionScheduleUpdateParams.Phase.Builder	setCoupon(EmptyParam coupon)	The identifier of the coupon to apply to this phase of the subscription schedule.
SubscriptionScheduleUpdateParams.Phase.Builder	setCoupon(String coupon)	The identifier of the coupon to apply to this phase of the subscription schedule.
SubscriptionScheduleUpdateParams.Phase.Builder	setCurrency(EmptyParam currency)	Three-letter ISO currency code, in lowercase.
SubscriptionScheduleUpdateParams.Phase.Builder	setCurrency(String currency)	Three-letter ISO currency code, in lowercase.
SubscriptionScheduleUpdateParams.Phase.Builder	setDefaultPaymentMethod(EmptyParam defaultPaymentMethod)	ID of the default payment method for the subscription schedule.
SubscriptionScheduleUpdateParams.Phase.Builder	setDefaultPaymentMethod(String defaultPaymentMethod)	ID of the default payment method for the subscription schedule.
SubscriptionScheduleUpdateParams.Phase.Builder	setDefaultTaxRates(EmptyParam defaultTaxRates)	A list of Tax Rate ids.
SubscriptionScheduleUpdateParams.Phase.Builder	setDefaultTaxRates(List<String> defaultTaxRates)	A list of Tax Rate ids.
SubscriptionScheduleUpdateParams.Phase.Builder	setDescription(EmptyParam description)	Subscription description, meant to be displayable to the customer.
SubscriptionScheduleUpdateParams.Phase.Builder	setDescription(String description)	Subscription description, meant to be displayable to the customer.
SubscriptionScheduleUpdateParams.Phase.Builder	setEndDate(SubscriptionScheduleUpdateParams.Phase.EndDate endDate)	The date at which this phase of the subscription schedule ends.
SubscriptionScheduleUpdateParams.Phase.Builder	setEndDate(Long endDate)	The date at which this phase of the subscription schedule ends.
SubscriptionScheduleUpdateParams.Phase.Builder	setInvoiceSettings(SubscriptionScheduleUpdateParams.Phase.InvoiceSettings invoiceSettings)	All invoices will be billed using the specified settings.
SubscriptionScheduleUpdateParams.Phase.Builder	setIterations(Long iterations)	Integer representing the multiplier applied to the price interval.
SubscriptionScheduleUpdateParams.Phase.Builder	setOnBehalfOf(EmptyParam onBehalfOf)	The account on behalf of which to charge, for each of the associated subscription's invoices.
SubscriptionScheduleUpdateParams.Phase.Builder	setOnBehalfOf(String onBehalfOf)	The account on behalf of which to charge, for each of the associated subscription's invoices.
SubscriptionScheduleUpdateParams.Phase.Builder	setProrationBehavior(SubscriptionScheduleUpdateParams.Phase.ProrationBehavior prorationBehavior)	Whether the subscription schedule will create prorations when transitioning to this phase.
SubscriptionScheduleUpdateParams.Phase.Builder	setStartDate(SubscriptionScheduleUpdateParams.Phase.StartDate startDate)	The date at which this phase of the subscription schedule starts or now.
SubscriptionScheduleUpdateParams.Phase.Builder	setStartDate(Long startDate)	The date at which this phase of the subscription schedule starts or now.
SubscriptionScheduleUpdateParams.Phase.Builder	setTransferData(SubscriptionScheduleUpdateParams.Phase.TransferData transferData)	The data with which to automatically create a Transfer for each of the associated subscription's invoices.
SubscriptionScheduleUpdateParams.Phase.Builder	setTrial(Boolean trial)	If set to true the entire phase is counted as a trial and the customer will not be charged for any fees.
SubscriptionScheduleUpdateParams.Phase.Builder	setTrialEnd(SubscriptionScheduleUpdateParams.Phase.TrialEnd trialEnd)	Sets the phase to trialing from the start date to this date.
SubscriptionScheduleUpdateParams.Phase.Builder	setTrialEnd(Long trialEnd)	Sets the phase to trialing from the start date to this date.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Builder

public Builder()

Method Details

build

public SubscriptionScheduleUpdateParams.Phase build()

Finalize and obtain parameter instance from this builder.

addAddInvoiceItem

public SubscriptionScheduleUpdateParams.Phase.Builder addAddInvoiceItem(SubscriptionScheduleUpdateParams.Phase.AddInvoiceItem element)

Add an element to `addInvoiceItems` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See SubscriptionScheduleUpdateParams.Phase.addInvoiceItems for the field documentation.

addAllAddInvoiceItem

public SubscriptionScheduleUpdateParams.Phase.Builder addAllAddInvoiceItem(List<SubscriptionScheduleUpdateParams.Phase.AddInvoiceItem> elements)

Add all elements to `addInvoiceItems` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See SubscriptionScheduleUpdateParams.Phase.addInvoiceItems for the field documentation.

setApplicationFeePercent

public SubscriptionScheduleUpdateParams.Phase.Builder setApplicationFeePercent(BigDecimal applicationFeePercent)

A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice subtotal that will be transferred to the application owner's Stripe account. The request must be made by a platform account on a connected account in order to set an application fee percentage. For more information, see the application fees documentation.

setAutomaticTax

public SubscriptionScheduleUpdateParams.Phase.Builder setAutomaticTax(SubscriptionScheduleUpdateParams.Phase.AutomaticTax automaticTax)

Automatic tax settings for this phase.

setBillingCycleAnchor

public SubscriptionScheduleUpdateParams.Phase.Builder setBillingCycleAnchor(SubscriptionScheduleUpdateParams.Phase.BillingCycleAnchor billingCycleAnchor)

Can be set to phase_start to set the anchor to the start of the phase or automatic to automatically change it if needed. Cannot be set to phase_start if this phase specifies a trial. For more information, see the billing cycle documentation.

setBillingThresholds

public SubscriptionScheduleUpdateParams.Phase.Builder setBillingThresholds(SubscriptionScheduleUpdateParams.Phase.BillingThresholds billingThresholds)

Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.

setBillingThresholds

public SubscriptionScheduleUpdateParams.Phase.Builder setBillingThresholds(EmptyParam billingThresholds)

Define thresholds at which an invoice will be sent, and the subscription advanced to a new billing period. Pass an empty string to remove previously-defined thresholds.

setCollectionMethod

public SubscriptionScheduleUpdateParams.Phase.Builder setCollectionMethod(SubscriptionScheduleUpdateParams.Phase.CollectionMethod collectionMethod)

Either charge_automatically, or send_invoice. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as active. Defaults to charge_automatically on creation.

setCoupon

public SubscriptionScheduleUpdateParams.Phase.Builder setCoupon(String coupon)

The identifier of the coupon to apply to this phase of the subscription schedule.

setCoupon

public SubscriptionScheduleUpdateParams.Phase.Builder setCoupon(EmptyParam coupon)

The identifier of the coupon to apply to this phase of the subscription schedule.

setCurrency

public SubscriptionScheduleUpdateParams.Phase.Builder setCurrency(String currency)

Three-letter ISO currency code, in lowercase. Must be a supported currency.

setCurrency

public SubscriptionScheduleUpdateParams.Phase.Builder setCurrency(EmptyParam currency)

Three-letter ISO currency code, in lowercase. Must be a supported currency.

setDefaultPaymentMethod

public SubscriptionScheduleUpdateParams.Phase.Builder setDefaultPaymentMethod(String defaultPaymentMethod)

ID of the default payment method for the subscription schedule. It must belong to the customer associated with the subscription schedule. If not set, invoices will use the default payment method in the customer's invoice settings.

setDefaultPaymentMethod

public SubscriptionScheduleUpdateParams.Phase.Builder setDefaultPaymentMethod(EmptyParam defaultPaymentMethod)

ID of the default payment method for the subscription schedule. It must belong to the customer associated with the subscription schedule. If not set, invoices will use the default payment method in the customer's invoice settings.

addDefaultTaxRate

public SubscriptionScheduleUpdateParams.Phase.Builder addDefaultTaxRate(String element)

Add an element to `defaultTaxRates` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See SubscriptionScheduleUpdateParams.Phase.defaultTaxRates for the field documentation.

addAllDefaultTaxRate

public SubscriptionScheduleUpdateParams.Phase.Builder addAllDefaultTaxRate(List<String> elements)

Add all elements to `defaultTaxRates` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See SubscriptionScheduleUpdateParams.Phase.defaultTaxRates for the field documentation.

setDefaultTaxRates

public SubscriptionScheduleUpdateParams.Phase.Builder setDefaultTaxRates(EmptyParam defaultTaxRates)

A list of Tax Rate ids. These Tax Rates will set the Subscription's default_tax_rates, which means they will be the Invoice's default_tax_rates for any Invoices issued by the Subscription during this Phase.

setDefaultTaxRates

public SubscriptionScheduleUpdateParams.Phase.Builder setDefaultTaxRates(List<String> defaultTaxRates)

A list of Tax Rate ids. These Tax Rates will set the Subscription's default_tax_rates, which means they will be the Invoice's default_tax_rates for any Invoices issued by the Subscription during this Phase.

setDescription

public SubscriptionScheduleUpdateParams.Phase.Builder setDescription(String description)

Subscription description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription.

setDescription

public SubscriptionScheduleUpdateParams.Phase.Builder setDescription(EmptyParam description)

Subscription description, meant to be displayable to the customer. Use this field to optionally store an explanation of the subscription.

setEndDate

public SubscriptionScheduleUpdateParams.Phase.Builder setEndDate(Long endDate)

The date at which this phase of the subscription schedule ends. If set, iterations must not be set.

setEndDate

public SubscriptionScheduleUpdateParams.Phase.Builder setEndDate(SubscriptionScheduleUpdateParams.Phase.EndDate endDate)

The date at which this phase of the subscription schedule ends. If set, iterations must not be set.

putExtraParam

public SubscriptionScheduleUpdateParams.Phase.Builder putExtraParam(String key,
 Object value)

Add a key/value pair to `extraParams` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See SubscriptionScheduleUpdateParams.Phase.extraParams for the field documentation.

putAllExtraParam

public SubscriptionScheduleUpdateParams.Phase.Builder putAllExtraParam(Map<String,Object> map)

Add all map key/value pairs to `extraParams` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See SubscriptionScheduleUpdateParams.Phase.extraParams for the field documentation.

setInvoiceSettings

public SubscriptionScheduleUpdateParams.Phase.Builder setInvoiceSettings(SubscriptionScheduleUpdateParams.Phase.InvoiceSettings invoiceSettings)

All invoices will be billed using the specified settings.

addItem

public SubscriptionScheduleUpdateParams.Phase.Builder addItem(SubscriptionScheduleUpdateParams.Phase.Item element)

Add an element to `items` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See SubscriptionScheduleUpdateParams.Phase.items for the field documentation.

addAllItem

public SubscriptionScheduleUpdateParams.Phase.Builder addAllItem(List<SubscriptionScheduleUpdateParams.Phase.Item> elements)

Add all elements to `items` list. A list is initialized for the first `add/addAll` call, and subsequent calls adds additional elements to the original list. See SubscriptionScheduleUpdateParams.Phase.items for the field documentation.

setIterations

public SubscriptionScheduleUpdateParams.Phase.Builder setIterations(Long iterations)

Integer representing the multiplier applied to the price interval. For example, iterations=2 applied to a price with interval=month and interval_count=3 results in a phase of duration 2 * 3 months = 6 months. If set, end_date must not be set.

putMetadata

public SubscriptionScheduleUpdateParams.Phase.Builder putMetadata(String key,
 String value)

Add a key/value pair to `metadata` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See SubscriptionScheduleUpdateParams.Phase.metadata for the field documentation.

putAllMetadata

public SubscriptionScheduleUpdateParams.Phase.Builder putAllMetadata(Map<String,String> map)

Add all map key/value pairs to `metadata` map. A map is initialized for the first `put/putAll` call, and subsequent calls add additional key/value pairs to the original map. See SubscriptionScheduleUpdateParams.Phase.metadata for the field documentation.

setOnBehalfOf

public SubscriptionScheduleUpdateParams.Phase.Builder setOnBehalfOf(String onBehalfOf)

The account on behalf of which to charge, for each of the associated subscription's invoices.

setOnBehalfOf

public SubscriptionScheduleUpdateParams.Phase.Builder setOnBehalfOf(EmptyParam onBehalfOf)

The account on behalf of which to charge, for each of the associated subscription's invoices.

setProrationBehavior

public SubscriptionScheduleUpdateParams.Phase.Builder setProrationBehavior(SubscriptionScheduleUpdateParams.Phase.ProrationBehavior prorationBehavior)

Whether the subscription schedule will create prorations when transitioning to this phase. The default value is create_prorations.

setStartDate

public SubscriptionScheduleUpdateParams.Phase.Builder setStartDate(Long startDate)

The date at which this phase of the subscription schedule starts or now. Must be set on the first phase.

setStartDate

public SubscriptionScheduleUpdateParams.Phase.Builder setStartDate(SubscriptionScheduleUpdateParams.Phase.StartDate startDate)

The date at which this phase of the subscription schedule starts or now. Must be set on the first phase.

setTransferData

public SubscriptionScheduleUpdateParams.Phase.Builder setTransferData(SubscriptionScheduleUpdateParams.Phase.TransferData transferData)

The data with which to automatically create a Transfer for each of the associated subscription's invoices.

setTrial

public SubscriptionScheduleUpdateParams.Phase.Builder setTrial(Boolean trial)

If set to true the entire phase is counted as a trial and the customer will not be charged for any fees.

setTrialEnd

public SubscriptionScheduleUpdateParams.Phase.Builder setTrialEnd(Long trialEnd)

Sets the phase to trialing from the start date to this date. Must be before the phase end date, can not be combined with trial

setTrialEnd

public SubscriptionScheduleUpdateParams.Phase.Builder setTrialEnd(SubscriptionScheduleUpdateParams.Phase.TrialEnd trialEnd)

Sets the phase to trialing from the start date to this date. Must be before the phase end date, can not be combined with trial