Package com.stripe.param

Class InvoiceUpcomingParams.ScheduleDetails.Phase.Builder

java.lang.Object

com.stripe.param.InvoiceUpcomingParams.ScheduleDetails.Phase.Builder

Enclosing class:

InvoiceUpcomingParams.ScheduleDetails.Phase

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

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

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

Finalize and obtain parameter instance from this builder.

addAddInvoiceItem

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

addAllAddInvoiceItem

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

setApplicationFeePercent

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

Automatic tax settings for this phase.

setBillingCycleAnchor

public InvoiceUpcomingParams.ScheduleDetails.Phase.Builder setBillingCycleAnchor(InvoiceUpcomingParams.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 InvoiceUpcomingParams.ScheduleDetails.Phase.Builder setBillingThresholds(InvoiceUpcomingParams.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 InvoiceUpcomingParams.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 InvoiceUpcomingParams.ScheduleDetails.Phase.Builder setCollectionMethod(InvoiceUpcomingParams.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 InvoiceUpcomingParams.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 InvoiceUpcomingParams.ScheduleDetails.Phase.Builder setCurrency(String currency)

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

setDefaultPaymentMethod

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

addAllDefaultTaxRate

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

setDefaultTaxRates

public InvoiceUpcomingParams.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 InvoiceUpcomingParams.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 InvoiceUpcomingParams.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 InvoiceUpcomingParams.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 InvoiceUpcomingParams.ScheduleDetails.Phase.Builder addDiscount(InvoiceUpcomingParams.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 InvoiceUpcomingParams.ScheduleDetails.Phase.discounts for the field documentation.

addAllDiscount

public InvoiceUpcomingParams.ScheduleDetails.Phase.Builder addAllDiscount(List<InvoiceUpcomingParams.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 InvoiceUpcomingParams.ScheduleDetails.Phase.discounts for the field documentation.

setDiscounts

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

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

putExtraParam

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

putAllExtraParam

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

setInvoiceSettings

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

All invoices will be billed using the specified settings.

addItem

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

addAllItem

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

setIterations

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

putAllMetadata

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

setOnBehalfOf

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

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

setProrationBehavior

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

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

setTrial

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