Package com.stripe.param

Class InvoiceUpcomingLinesParams

java.lang.Object
com.stripe.net.ApiRequestParams
com.stripe.param.InvoiceUpcomingLinesParams
public class InvoiceUpcomingLinesParams extends ApiRequestParams

  • Method Details

    • builder

      public static InvoiceUpcomingLinesParams.Builder builder()

    • getAutomaticTax

      public InvoiceUpcomingLinesParams.AutomaticTax getAutomaticTax()
      Settings for automatic tax lookup for this invoice preview.

    • getCoupon

      public String getCoupon()
      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.

    • getCurrency

      public String getCurrency()
      The currency to preview this invoice in. Defaults to that of customer if not specified.

    • getCustomer

      public String getCustomer()
      The identifier of the customer whose upcoming invoice you'd like to retrieve. If automatic_tax is enabled then one of customer, customer_details, subscription, or schedule must be set.

    • getCustomerDetails

      public InvoiceUpcomingLinesParams.CustomerDetails getCustomerDetails()
      Details about the customer you want to invoice or overrides for an existing customer. If automatic_tax is enabled then one of customer, customer_details, subscription, or schedule must be set.

    • getDiscounts

      public Object getDiscounts()
      The coupons to redeem into discounts for the invoice preview. If not specified, inherits the discount from the subscription or customer. This works for both coupons directly applied to an invoice and coupons applied to a subscription. Pass an empty string to avoid inheriting any discounts.

    • getEndingBefore

      public String getEndingBefore()
      A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.

    • getExpand

      public List<String> getExpand()
      Specifies which fields in the response should be expanded.

    • getExtraParams

      public Map<String,Object> getExtraParams()
      Map of extra parameters for custom features not available in this client library. The content in this map is not serialized under this field's @SerializedName value. Instead, each key/value pair is serialized as if the key is a root-level field (serialized) name in this param object. Effectively, this map is flattened to its parent instance.

    • getInvoiceItems

      public List<InvoiceUpcomingLinesParams.InvoiceItem> getInvoiceItems()
      List of invoice items to add or update in the upcoming invoice preview.

    • getIssuer

      public InvoiceUpcomingLinesParams.Issuer getIssuer()
      The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.

    • getLimit

      public Long getLimit()
      A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

    • getOnBehalfOf

      public Object getOnBehalfOf()
      The account (if any) for which the funds of the invoice payment are intended. If set, the invoice will be presented with the branding and support information of the specified account. See the Invoices with Connect documentation for details.

    • getPreviewMode

      public InvoiceUpcomingLinesParams.PreviewMode getPreviewMode()
      Customizes the types of values to include when calculating the invoice. Defaults to next if unspecified.

    • getSchedule

      public String getSchedule()
      The identifier of the schedule whose upcoming invoice you'd like to retrieve. Cannot be used with subscription or subscription fields.

    • getScheduleDetails

      public InvoiceUpcomingLinesParams.ScheduleDetails getScheduleDetails()
      The schedule creation or modification params to apply as a preview. Cannot be used with subscription or subscription_ prefixed fields.

    • getStartingAfter

      public String getStartingAfter()
      A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.

    • getSubscription

      public String getSubscription()
      The identifier of the subscription for which you'd like to retrieve the upcoming invoice. If not provided, but a subscription_details.items is provided, you will preview creating a subscription with those items. If neither subscription nor subscription_details.items is provided, you will retrieve the next upcoming invoice from among the customer's subscriptions.

    • getSubscriptionBillingCycleAnchor

      public Object getSubscriptionBillingCycleAnchor()
      For new subscriptions, a future timestamp to anchor the subscription's billing cycle. This is used to determine the date of the first full invoice, and, for plans with month or year intervals, the day of the month for subsequent invoices. For existing subscriptions, the value can only be set to now or unchanged. This field has been deprecated and will be removed in a future API version. Use subscription_details.billing_cycle_anchor instead.

    • getSubscriptionCancelAt

      public Object getSubscriptionCancelAt()
      A timestamp at which the subscription should cancel. If set to a date before the current period ends, this will cause a proration if prorations have been enabled using proration_behavior. If set during a future period, this will always cause a proration for that period. This field has been deprecated and will be removed in a future API version. Use subscription_details.cancel_at instead.

    • getSubscriptionCancelAtPeriodEnd

      public Boolean getSubscriptionCancelAtPeriodEnd()
      Indicate whether this subscription should cancel at the end of the current period ( current_period_end). Defaults to false. This field has been deprecated and will be removed in a future API version. Use subscription_details.cancel_at_period_end instead.

    • getSubscriptionCancelNow

      public Boolean getSubscriptionCancelNow()
      This simulates the subscription being canceled or expired immediately. This field has been deprecated and will be removed in a future API version. Use subscription_details.cancel_now instead.

    • getSubscriptionDefaultTaxRates

      public Object getSubscriptionDefaultTaxRates()
      If provided, the invoice returned will preview updating or creating a subscription with these default tax rates. The default tax rates will apply to any line item that does not have tax_rates set. This field has been deprecated and will be removed in a future API version. Use subscription_details.default_tax_rates instead.

    • getSubscriptionDetails

      public InvoiceUpcomingLinesParams.SubscriptionDetails getSubscriptionDetails()
      The subscription creation or modification params to apply as a preview. Cannot be used with schedule or schedule_details fields.

    • getSubscriptionItems

      public List<InvoiceUpcomingLinesParams.SubscriptionItem> getSubscriptionItems()
      A list of up to 20 subscription items, each with an attached price. This field has been deprecated and will be removed in a future API version. Use subscription_details.items instead.

    • getSubscriptionProrationBehavior

      public InvoiceUpcomingLinesParams.SubscriptionProrationBehavior getSubscriptionProrationBehavior()
      Determines how to handle prorations when the billing cycle changes (e.g., when switching plans, resetting billing_cycle_anchor=now, or starting a trial), or if an item's quantity changes. The default value is create_prorations. This field has been deprecated and will be removed in a future API version. Use subscription_details.proration_behavior instead.

    • getSubscriptionProrationDate

      public Long getSubscriptionProrationDate()
      If previewing an update to a subscription, and doing proration, subscription_proration_date forces the proration to be calculated as though the update was done at the specified time. The time given must be within the current subscription period and within the current phase of the schedule backing this subscription, if the schedule exists. If set, subscription, and one of subscription_items, or subscription_trial_end are required. Also, subscription_proration_behavior cannot be set to 'none'. This field has been deprecated and will be removed in a future API version. Use subscription_details.proration_date instead.

    • getSubscriptionResumeAt

      public InvoiceUpcomingLinesParams.SubscriptionResumeAt getSubscriptionResumeAt()
      For paused subscriptions, setting subscription_resume_at to now will preview the invoice that will be generated if the subscription is resumed. This field has been deprecated and will be removed in a future API version. Use subscription_details.resume_at instead.

    • getSubscriptionStartDate

      public Long getSubscriptionStartDate()
      Date a subscription is intended to start (can be future or past). This field has been deprecated and will be removed in a future API version. Use subscription_details.start_date instead.

    • getSubscriptionTrialEnd

      public Object getSubscriptionTrialEnd()
      If provided, the invoice returned will preview updating or creating a subscription with that trial end. If set, one of subscription_items or subscription is required. This field has been deprecated and will be removed in a future API version. Use subscription_details.trial_end instead.

    • getSubscriptionTrialFromPlan

      public Boolean getSubscriptionTrialFromPlan()
      Indicates if a plan's trial_period_days should be applied to the subscription. Setting subscription_trial_end per subscription is preferred, and this defaults to false. Setting this flag to true together with subscription_trial_end is not allowed. See Using trial periods on subscriptions to learn more.