Package com.stripe.param

Class InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder

java.lang.Object

com.stripe.param.InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder

Enclosing class:

InvoiceUpcomingLinesListParams.ScheduleDetails.Phase

public static class InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder
extends Object

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

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

Finalize and obtain parameter instance from this builder.

addAddInvoiceItem

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder addAddInvoiceItem(InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.addInvoiceItems for the field documentation.

addAllAddInvoiceItem

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder addAllAddInvoiceItem(List<InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.addInvoiceItems for the field documentation.

setApplicationFeePercent

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 total 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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setAutomaticTax(InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.AutomaticTax automaticTax)

Automatic tax settings for this phase.

setBillingCycleAnchor

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setBillingCycleAnchor(InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setBillingThresholds(InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setCollectionMethod(InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setCoupon(String coupon)

The ID of the coupon to apply to this phase of the subscription schedule. This field has been deprecated and will be removed in a future API version. Use discounts instead.

setCurrency

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setCurrency(String currency)

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

setDefaultPaymentMethod

public InvoiceUpcomingLinesListParams.ScheduleDetails.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.

addDefaultTaxRate

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.defaultTaxRates for the field documentation.

addAllDefaultTaxRate

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.defaultTaxRates for the field documentation.

setDefaultTaxRates

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.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 for rendering in Stripe surfaces and certain local payment methods UIs.

setDescription

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 for rendering in Stripe surfaces and certain local payment methods UIs.

addDiscount

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder addDiscount(InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Discount element)

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

addAllDiscount

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder addAllDiscount(List<InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Discount> elements)

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

setDiscounts

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setDiscounts(EmptyParam discounts)

The coupons to redeem into discounts for the schedule phase. If not specified, inherits the discount from the subscription's customer. Pass an empty string to avoid inheriting any discounts.

setDiscounts

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setDiscounts(List<InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Discount> discounts)

The coupons to redeem into discounts for the schedule phase. If not specified, inherits the discount from the subscription's customer. Pass an empty string to avoid inheriting any discounts.

setEndDate

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setEndDate(InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.EndDate endDate)

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

putExtraParam

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.extraParams for the field documentation.

putAllExtraParam

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.extraParams for the field documentation.

setInvoiceSettings

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setInvoiceSettings(InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.InvoiceSettings invoiceSettings)

All invoices will be billed using the specified settings.

addItem

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder addItem(InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.items for the field documentation.

addAllItem

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder addAllItem(List<InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.items for the field documentation.

setIterations

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.metadata for the field documentation.

putAllMetadata

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.metadata for the field documentation.

setOnBehalfOf

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setOnBehalfOf(String onBehalfOf)

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

setProrationBehavior

public InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setProrationBehavior(InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.ProrationBehavior prorationBehavior)

Whether the subscription schedule will create prorations when transitioning to this phase. The default value is create_prorations. This setting controls prorations when a phase is started asynchronously and it is persisted as a field on the phase. It's different from the request-level proration_behavior parameter which controls what happens if the update request affects the billing configuration of the current phase.

setStartDate

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setStartDate(InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setTransferData(InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.TransferData transferData)

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

setTrial

public InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.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 InvoiceUpcomingLinesListParams.ScheduleDetails.Phase.Builder setTrialEnd(InvoiceUpcomingLinesListParams.ScheduleDetails.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