stripe / stripe-java / #16599

// File generated from our OpenAPI spec

package com.stripe.model;

import com.google.gson.annotations.SerializedName;

import com.stripe.exception.StripeException;

import com.stripe.model.billing.CreditBalanceTransaction;

import com.stripe.model.testhelpers.TestClock;

import com.stripe.net.ApiRequest;

import com.stripe.net.ApiRequestParams;

import com.stripe.net.ApiResource;

import com.stripe.net.BaseAddress;

import com.stripe.net.RequestOptions;

import com.stripe.net.StripeResponseGetter;

import com.stripe.param.InvoiceAddLinesParams;

import com.stripe.param.InvoiceAttachPaymentIntentParams;

import com.stripe.param.InvoiceAttachPaymentParams;

import com.stripe.param.InvoiceCreateParams;

import com.stripe.param.InvoiceCreatePreviewParams;

import com.stripe.param.InvoiceFinalizeInvoiceParams;

import com.stripe.param.InvoiceListParams;

import com.stripe.param.InvoiceMarkUncollectibleParams;

import com.stripe.param.InvoicePayParams;

import com.stripe.param.InvoiceRemoveLinesParams;

import com.stripe.param.InvoiceRetrieveParams;

import com.stripe.param.InvoiceSearchParams;

import com.stripe.param.InvoiceSendInvoiceParams;

import com.stripe.param.InvoiceUpcomingLinesParams;

import com.stripe.param.InvoiceUpcomingParams;

import com.stripe.param.InvoiceUpdateLinesParams;

import com.stripe.param.InvoiceUpdateParams;

import com.stripe.param.InvoiceVoidInvoiceParams;

import java.util.List;

import java.util.Map;

import java.util.stream.Collectors;

import lombok.EqualsAndHashCode;

import lombok.Getter;

import lombok.Setter;

/**

 * Invoices are statements of amounts owed by a customer, and are either generated one-off, or

 * generated periodically from a subscription.

 *

 * <p>They contain <a href="https://stripe.com/docs/api#invoiceitems">invoice items</a>, and

 * proration adjustments that may be caused by subscription upgrades/downgrades (if necessary).

 *

 * <p>If your invoice is configured to be billed through automatic charges, Stripe automatically

 * finalizes your invoice and attempts payment. Note that finalizing the invoice, <a

 * href="https://stripe.com/docs/invoicing/integration/automatic-advancement-collection">when

 * automatic</a>, does not happen immediately as the invoice is created. Stripe waits until one hour

 * after the last webhook was successfully sent (or the last webhook timed out after failing). If

 * you (and the platforms you may have connected to) have no webhooks configured, Stripe waits one

 * hour after creation to finalize the invoice.

 *

 * <p>If your invoice is configured to be billed by sending an email, then based on your <a

 * href="https://dashboard.stripe.com/account/billing/automatic">email settings</a>, Stripe will

 * email the invoice to your customer and await payment. These emails can contain a link to a hosted

 * page to pay the invoice.

 *

 * <p>Stripe applies any customer credit on the account before determining the amount due for the

 * invoice (i.e., the amount that will be actually charged). If the amount due for the invoice is

 * less than Stripe's <a

 * href="https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts">minimum allowed

 * charge per currency</a>, the invoice is automatically marked paid, and we add the amount due to

 * the customer's credit balance which is applied to the next invoice.

 *

 * <p>More details on the customer's credit balance are <a

 * href="https://stripe.com/docs/billing/customer/balance">here</a>.

 *

 * <p>Related guide: <a href="https://stripe.com/docs/billing/invoices/sending">Send invoices to

 * customers</a>

 */

@Getter

@Setter

@EqualsAndHashCode(callSuper = false)

  /**

   * The country of the business associated with this invoice, most often the business creating the

   * invoice.

   */

  @SerializedName("account_country")

  String accountCountry;

  /**

   * The public name of the business associated with this invoice, most often the business creating

   * the invoice.

   */

  @SerializedName("account_name")

  String accountName;

  /** The account tax IDs associated with the invoice. Only editable when the invoice is a draft. */

  @SerializedName("account_tax_ids")

  List<ExpandableField<TaxId>> accountTaxIds;

  /**

   * Final amount due at this time for this invoice. If the invoice's total is smaller than the

   * minimum charge amount, for example, or if there is account credit that can be applied to the

   * invoice, the {@code amount_due} may be 0. If there is a positive {@code starting_balance} for

   * the invoice (the customer owes money), the {@code amount_due} will also take that into account.

   * The charge that gets generated for the invoice will be for the amount specified in {@code

   * amount_due}.

   */

  @SerializedName("amount_due")

  Long amountDue;

  /** The amount, in cents (or local equivalent), that was paid. */

  @SerializedName("amount_paid")

  Long amountPaid;

  /** The difference between amount_due and amount_paid, in cents (or local equivalent). */

  @SerializedName("amount_remaining")

  Long amountRemaining;

  /** This is the sum of all the shipping amounts. */

  @SerializedName("amount_shipping")

  Long amountShipping;

  /**

   * List of expected payments and corresponding due dates. This value will be null for invoices

   * where collection_method=charge_automatically.

   */

  @SerializedName("amounts_due")

  List<Invoice.AmountsDue> amountsDue;

  /** ID of the Connect Application that created the invoice. */

  @SerializedName("application")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Application> application;

  /**

   * The fee in cents (or local equivalent) that will be applied to the invoice and transferred to

   * the application owner's Stripe account when the invoice is paid.

   */

  @SerializedName("application_fee_amount")

  Long applicationFeeAmount;

  /**

   * Number of payment attempts made for this invoice, from the perspective of the payment retry

   * schedule. Any payment attempt counts as the first attempt, and subsequently only automatic

   * retries increment the attempt count. In other words, manual payment attempts after the first

   * attempt do not affect the retry schedule. If a failure is returned with a non-retryable return

   * code, the invoice can no longer be retried unless a new payment method is obtained. Retries

   * will continue to be scheduled, and attempt_count will continue to increment, but retries will

   * only be executed if a new payment method is obtained.

   */

  @SerializedName("attempt_count")

  Long attemptCount;

  /**

   * Whether an attempt has been made to pay the invoice. An invoice is not attempted until 1 hour

   * after the {@code invoice.created} webhook, for example, so you might not want to display that

   * invoice as unpaid to your users.

   */

  @SerializedName("attempted")

  Boolean attempted;

  /**

   * Controls whether Stripe performs <a

   * href="https://stripe.com/docs/invoicing/integration/automatic-advancement-collection">automatic

   * collection</a> of the invoice. If {@code false}, the invoice's state doesn't automatically

   * advance without an explicit action.

   */

  @SerializedName("auto_advance")

  Boolean autoAdvance;

  @SerializedName("automatic_tax")

  AutomaticTax automaticTax;

  /**

   * The time when this invoice is currently scheduled to be automatically finalized. The field will

   * be {@code null} if the invoice is not scheduled to finalize in the future. If the invoice is

   * not in the draft state, this field will always be {@code null} - see {@code finalized_at} for

   * the time when an already-finalized invoice was finalized.

   */

  @SerializedName("automatically_finalizes_at")

  Long automaticallyFinalizesAt;

  /**

   * Indicates the reason why the invoice was created.

   *

   * <p>* {@code manual}: Unrelated to a subscription, for example, created via the invoice editor.

   * * {@code subscription}: No longer in use. Applies to subscriptions from before May 2018 where

   * no distinction was made between updates, cycles, and thresholds. * {@code subscription_create}:

   * A new subscription was created. * {@code subscription_cycle}: A subscription advanced into a

   * new period. * {@code subscription_threshold}: A subscription reached a billing threshold. *

   * {@code subscription_update}: A subscription was updated. * {@code upcoming}: Reserved for

   * simulated invoices, per the upcoming invoice endpoint.

   *

   * <p>One of {@code automatic_pending_invoice_item_invoice}, {@code manual}, {@code quote_accept},

   * {@code subscription}, {@code subscription_create}, {@code subscription_cycle}, {@code

   * subscription_threshold}, {@code subscription_update}, or {@code upcoming}.

   */

  @SerializedName("billing_reason")

  String billingReason;

  /** ID of the latest charge generated for this invoice, if any. */

  @SerializedName("charge")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Charge> charge;

  /**

   * Either {@code charge_automatically}, or {@code send_invoice}. When charging automatically,

   * Stripe will attempt to pay this invoice using the default source attached to the customer. When

   * sending an invoice, Stripe will email this invoice to the customer with payment instructions.

   *

   * <p>One of {@code charge_automatically}, or {@code send_invoice}.

   */

  @SerializedName("collection_method")

  String collectionMethod;

  /** Time at which the object was created. Measured in seconds since the Unix epoch. */

  @SerializedName("created")

  Long created;

  /**

   * Three-letter <a href="https://www.iso.org/iso-4217-currency-codes.html">ISO currency code</a>,

   * in lowercase. Must be a <a href="https://stripe.com/docs/currencies">supported currency</a>.

   */

  @SerializedName("currency")

  String currency;

  /** Custom fields displayed on the invoice. */

  @SerializedName("custom_fields")

  List<Invoice.CustomField> customFields;

  /** The ID of the customer who will be billed. */

  @SerializedName("customer")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Customer> customer;

  /**

   * The customer's address. Until the invoice is finalized, this field will equal {@code

   * customer.address}. Once the invoice is finalized, this field will no longer be updated.

   */

  @SerializedName("customer_address")

  Address customerAddress;

  /**

   * The customer's email. Until the invoice is finalized, this field will equal {@code

   * customer.email}. Once the invoice is finalized, this field will no longer be updated.

   */

  @SerializedName("customer_email")

  String customerEmail;

  /**

   * The customer's name. Until the invoice is finalized, this field will equal {@code

   * customer.name}. Once the invoice is finalized, this field will no longer be updated.

   */

  @SerializedName("customer_name")

  String customerName;

  /**

   * The customer's phone number. Until the invoice is finalized, this field will equal {@code

   * customer.phone}. Once the invoice is finalized, this field will no longer be updated.

   */

  @SerializedName("customer_phone")

  String customerPhone;

  /**

   * The customer's shipping information. Until the invoice is finalized, this field will equal

   * {@code customer.shipping}. Once the invoice is finalized, this field will no longer be updated.

   */

  @SerializedName("customer_shipping")

  ShippingDetails customerShipping;

  /**

   * The customer's tax exempt status. Until the invoice is finalized, this field will equal {@code

   * customer.tax_exempt}. Once the invoice is finalized, this field will no longer be updated.

   *

   * <p>One of {@code exempt}, {@code none}, or {@code reverse}.

   */

  @SerializedName("customer_tax_exempt")

  String customerTaxExempt;

  /**

   * The customer's tax IDs. Until the invoice is finalized, this field will contain the same tax

   * IDs as {@code customer.tax_ids}. Once the invoice is finalized, this field will no longer be

   * updated.

   */

  @SerializedName("customer_tax_ids")

  List<Invoice.CustomerTaxId> customerTaxIds;

  /**

   * The margins applied to the invoice. Can be overridden by line item {@code margins}. Use {@code

   * expand[]=default_margins} to expand each margin.

   */

  @SerializedName("default_margins")

  List<ExpandableField<Margin>> defaultMargins;

  /**

   * ID of the default payment method for the invoice. It must belong to the customer associated

   * with the invoice. If not set, defaults to the subscription's default payment method, if any, or

   * to the default payment method in the customer's invoice settings.

   */

  @SerializedName("default_payment_method")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<PaymentMethod> defaultPaymentMethod;

  /**

   * ID of the default payment source for the invoice. It must belong to the customer associated

   * with the invoice and be in a chargeable state. If not set, defaults to the subscription's

   * default source, if any, or to the customer's default source.

   */

  @SerializedName("default_source")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<PaymentSource> defaultSource;

  /** The tax rates applied to this invoice, if any. */

  @SerializedName("default_tax_rates")

  List<TaxRate> defaultTaxRates;

  /** Always true for a deleted object. */

  @SerializedName("deleted")

  Boolean deleted;

  /**

   * An arbitrary string attached to the object. Often useful for displaying to users. Referenced as

   * 'memo' in the Dashboard.

   */

  @SerializedName("description")

  String description;

  /**

   * Describes the current discount applied to this invoice, if there is one. Not populated if there

   * are multiple discounts.

   */

  @SerializedName("discount")

  Discount discount;

  /**

   * The discounts applied to the invoice. Line item discounts are applied before invoice discounts.

   * Use {@code expand[]=discounts} to expand each discount.

   */

  @SerializedName("discounts")

  List<ExpandableField<Discount>> discounts;

  /**

   * The date on which payment for this invoice is due. This value will be {@code null} for invoices

   * where {@code collection_method=charge_automatically}.

   */

  @SerializedName("due_date")

  Long dueDate;

  /**

   * The date when this invoice is in effect. Same as {@code finalized_at} unless overwritten. When

   * defined, this value replaces the system-generated 'Date of issue' printed on the invoice PDF

   * and receipt.

   */

  @SerializedName("effective_at")

  Long effectiveAt;

  /**

   * Ending customer balance after the invoice is finalized. Invoices are finalized approximately an

   * hour after successful webhook delivery or when payment collection is attempted for the invoice.

   * If the invoice has not been finalized yet, this will be null.

   */

  @SerializedName("ending_balance")

  Long endingBalance;

  /** Footer displayed on the invoice. */

  @SerializedName("footer")

  String footer;

  /**

   * Details of the invoice that was cloned. See the <a

   * href="https://stripe.com/docs/invoicing/invoice-revisions">revision documentation</a> for more

   * details.

   */

  @SerializedName("from_invoice")

  FromInvoice fromInvoice;

  /**

   * The URL for the hosted invoice page, which allows customers to view and pay an invoice. If the

   * invoice has not been finalized yet, this will be null.

   */

  @SerializedName("hosted_invoice_url")

  String hostedInvoiceUrl;

  /**

   * Unique identifier for the object. This property is always present unless the invoice is an

   * upcoming invoice. See <a href="https://stripe.com/docs/api/invoices/upcoming">Retrieve an

   * upcoming invoice</a> for more details.

   */

  @Getter(onMethod_ = {@Override})

  @SerializedName("id")

  String id;

  /**

   * The link to download the PDF for the invoice. If the invoice has not been finalized yet, this

   * will be null.

   */

  @SerializedName("invoice_pdf")

  String invoicePdf;

  @SerializedName("issuer")

  Issuer issuer;

  /**

   * The error encountered during the previous attempt to finalize the invoice. This field is

   * cleared when the invoice is successfully finalized.

   */

  @SerializedName("last_finalization_error")

  StripeError lastFinalizationError;

  /** The ID of the most recent non-draft revision of this invoice. */

  @SerializedName("latest_revision")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Invoice> latestRevision;

  /**

   * The individual line items that make up the invoice. {@code lines} is sorted as follows: (1)

   * pending invoice items (including prorations) in reverse chronological order, (2) subscription

   * items in reverse chronological order, and (3) invoice items added after invoice creation in

   * chronological order.

   */

  @SerializedName("lines")

  InvoiceLineItemCollection lines;

  /**

   * Has the value {@code true} if the object exists in live mode or the value {@code false} if the

   * object exists in test mode.

   */

  @SerializedName("livemode")

  Boolean livemode;

  /**

   * Set of <a href="https://stripe.com/docs/api/metadata">key-value pairs</a> that you can attach

   * to an object. This can be useful for storing additional information about the object in a

   * structured format.

   */

  @Getter(onMethod_ = {@Override})

  @SerializedName("metadata")

  Map<String, String> metadata;

  /**

   * The time at which payment will next be attempted. This value will be {@code null} for invoices

   * where {@code collection_method=send_invoice}.

   */

  @SerializedName("next_payment_attempt")

  Long nextPaymentAttempt;

  /**

   * A unique, identifying string that appears on emails sent to the customer for this invoice. This

   * starts with the customer's unique invoice_prefix if it is specified.

   */

  @SerializedName("number")

  String number;

  /**

   * String representing the object's type. Objects of the same type share the same value.

   *

   * <p>Equal to {@code invoice}.

   */

  @SerializedName("object")

  String object;

  /**

   * 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 <a href="https://stripe.com/docs/billing/invoices/connect">Invoices with Connect</a>

   * documentation for details.

   */

  @SerializedName("on_behalf_of")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Account> onBehalfOf;

  /**

   * Whether payment was successfully collected for this invoice. An invoice can be paid (most

   * commonly) with a charge or with credit from the customer's account balance.

   */

  @SerializedName("paid")

  Boolean paid;

  /**

   * Returns true if the invoice was manually marked paid, returns false if the invoice hasn't been

   * paid yet or was paid on Stripe.

   */

  @SerializedName("paid_out_of_band")

  Boolean paidOutOfBand;

  /**

   * The PaymentIntent associated with this invoice. The PaymentIntent is generated when the invoice

   * is finalized, and can then be used to pay the invoice. Note that voiding an invoice will cancel

   * the PaymentIntent.

   */

  @SerializedName("payment_intent")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<PaymentIntent> paymentIntent;

  @SerializedName("payment_settings")

  PaymentSettings paymentSettings;

  /** Payments for this invoice. */

  @SerializedName("payments")

  InvoicePaymentCollection payments;

  /**

   * End of the usage period during which invoice items were added to this invoice. This looks back

   * one period for a subscription invoice. Use the <a

   * href="https://stripe.com/api/invoices/line_item#invoice_line_item_object-period">line item

   * period</a> to get the service period for each price.

   */

  @SerializedName("period_end")

  Long periodEnd;

  /**

   * Start of the usage period during which invoice items were added to this invoice. This looks

   * back one period for a subscription invoice. Use the <a

   * href="https://stripe.com/api/invoices/line_item#invoice_line_item_object-period">line item

   * period</a> to get the service period for each price.

   */

  @SerializedName("period_start")

  Long periodStart;

  /** Total amount of all post-payment credit notes issued for this invoice. */

  @SerializedName("post_payment_credit_notes_amount")

  Long postPaymentCreditNotesAmount;

  /** Total amount of all pre-payment credit notes issued for this invoice. */

  @SerializedName("pre_payment_credit_notes_amount")

  Long prePaymentCreditNotesAmount;

  /** The quote this invoice was generated from. */

  @SerializedName("quote")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Quote> quote;

  /** This is the transaction number that appears on email receipts sent for this invoice. */

  @SerializedName("receipt_number")

  String receiptNumber;

  /**

   * The rendering-related settings that control how the invoice is displayed on customer-facing

   * surfaces such as PDF and Hosted Invoice Page.

   */

  @SerializedName("rendering")

  Rendering rendering;

  /** The details of the cost of shipping, including the ShippingRate applied on the invoice. */

  @SerializedName("shipping_cost")

  ShippingCost shippingCost;

  /**

   * Shipping details for the invoice. The Invoice PDF will use the {@code shipping_details} value

   * if it is set, otherwise the PDF will render the shipping address from the customer.

   */

  @SerializedName("shipping_details")

  ShippingDetails shippingDetails;

  /**

   * Starting customer balance before the invoice is finalized. If the invoice has not been

   * finalized yet, this will be the current customer balance. For revision invoices, this also

   * includes any customer balance that was applied to the original invoice.

   */

  @SerializedName("starting_balance")

  Long startingBalance;

  /** Extra information about an invoice for the customer's credit card statement. */

  @SerializedName("statement_descriptor")

  String statementDescriptor;

  /**

   * The status of the invoice, one of {@code draft}, {@code open}, {@code paid}, {@code

   * uncollectible}, or {@code void}. <a

   * href="https://stripe.com/docs/billing/invoices/workflow#workflow-overview">Learn more</a>

   */

  @SerializedName("status")

  String status;

  @SerializedName("status_transitions")

  StatusTransitions statusTransitions;

  /** The subscription that this invoice was prepared for, if any. */

  @SerializedName("subscription")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<Subscription> subscription;

  /** Details about the subscription that created this invoice. */

  @SerializedName("subscription_details")

  SubscriptionDetails subscriptionDetails;

  /**

   * Only set for upcoming invoices that preview prorations. The time used to calculate prorations.

   */

  @SerializedName("subscription_proration_date")

  Long subscriptionProrationDate;

  /**

   * Total of all subscriptions, invoice items, and prorations on the invoice before any invoice

   * level discount or exclusive tax is applied. Item discounts are already incorporated

   */

  @SerializedName("subtotal")

  Long subtotal;

  /**

   * The integer amount in cents (or local equivalent) representing the subtotal of the invoice

   * before any invoice level discount or tax is applied. Item discounts are already incorporated

   */

  @SerializedName("subtotal_excluding_tax")

  Long subtotalExcludingTax;

  /** The amount of tax on this invoice. This is the sum of all the tax amounts on this invoice. */

  @SerializedName("tax")

  Long tax;

  /** ID of the test clock this invoice belongs to. */

  @SerializedName("test_clock")

  @Getter(lombok.AccessLevel.NONE)

  @Setter(lombok.AccessLevel.NONE)

  ExpandableField<TestClock> testClock;

  @SerializedName("threshold_reason")

  ThresholdReason thresholdReason;

  /** Total after discounts and taxes. */

  @SerializedName("total")

  Long total;

  /** The aggregate amounts calculated per discount across all line items. */

  @SerializedName("total_discount_amounts")

  List<Invoice.TotalDiscountAmount> totalDiscountAmounts;

  /**

   * The integer amount in cents (or local equivalent) representing the total amount of the invoice

   * including all discounts but excluding all tax.

   */

  @SerializedName("total_excluding_tax")

  Long totalExcludingTax;

  /** The aggregate amounts calculated per margin across all line items. */

  @SerializedName("total_margin_amounts")

  List<Invoice.TotalMarginAmount> totalMarginAmounts;

  /**

   * Contains pretax credit amounts (ex: discount, credit grants, etc) that apply to this invoice.

   * This is a combined list of total_pretax_credit_amounts across all invoice line items.

   */

  @SerializedName("total_pretax_credit_amounts")

  List<Invoice.TotalPretaxCreditAmount> totalPretaxCreditAmounts;

  /** The aggregate amounts calculated per tax rate for all line items. */

  @SerializedName("total_tax_amounts")

  List<Invoice.TotalTaxAmount> totalTaxAmounts;

  /**

   * The account (if any) the payment will be attributed to for tax reporting, and where funds from

   * the payment will be transferred to for the invoice.

   */

  @SerializedName("transfer_data")

  TransferData transferData;

  /**

   * Invoices are automatically paid or sent 1 hour after webhooks are delivered, or until all

   * webhook delivery attempts have <a

   * href="https://stripe.com/docs/billing/webhooks#understand">been exhausted</a>. This field

   * tracks the time when webhooks for this invoice were successfully delivered. If the invoice had

   * no webhooks to deliver, this will be set while the invoice is being created.

   */

  @SerializedName("webhooks_delivered_at")

  Long webhooksDeliveredAt;

  /** Get ID of expandable {@code application} object. */

  public String getApplication() {

  }

  public void setApplication(String id) {

  /** Get expanded {@code application}. */

  public Application getApplicationObject() {

  }

  public void setApplicationObject(Application expandableObject) {

  /** Get ID of expandable {@code charge} object. */

  public String getCharge() {

  }

  public void setCharge(String id) {

  /** Get expanded {@code charge}. */

  public Charge getChargeObject() {

  }

  public void setChargeObject(Charge expandableObject) {

  /** Get ID of expandable {@code customer} object. */

  public String getCustomer() {

  }

  public void setCustomer(String id) {

  /** Get expanded {@code customer}. */

  public Customer getCustomerObject() {

  }

  public void setCustomerObject(Customer expandableObject) {

  /** Get ID of expandable {@code defaultPaymentMethod} object. */

  public String getDefaultPaymentMethod() {

  }

  public void setDefaultPaymentMethod(String id) {

  /** Get expanded {@code defaultPaymentMethod}. */

  public PaymentMethod getDefaultPaymentMethodObject() {

  }

  public void setDefaultPaymentMethodObject(PaymentMethod expandableObject) {

  /** Get ID of expandable {@code defaultSource} object. */

  public String getDefaultSource() {

  }

  public void setDefaultSource(String id) {

  /** Get expanded {@code defaultSource}. */

  public PaymentSource getDefaultSourceObject() {

  }

  public void setDefaultSourceObject(PaymentSource expandableObject) {

  /** Get ID of expandable {@code latestRevision} object. */

  public String getLatestRevision() {

  }

  public void setLatestRevision(String id) {

  /** Get expanded {@code latestRevision}. */

  public Invoice getLatestRevisionObject() {

  }

  public void setLatestRevisionObject(Invoice expandableObject) {

  /** Get ID of expandable {@code onBehalfOf} object. */

  public String getOnBehalfOf() {

  }

  public void setOnBehalfOf(String id) {

  /** Get expanded {@code onBehalfOf}. */

  public Account getOnBehalfOfObject() {

  }

  public void setOnBehalfOfObject(Account expandableObject) {

  /** Get ID of expandable {@code paymentIntent} object. */

  public String getPaymentIntent() {

  }

  public void setPaymentIntent(String id) {

  /** Get expanded {@code paymentIntent}. */

  public PaymentIntent getPaymentIntentObject() {

  }

  public void setPaymentIntentObject(PaymentIntent expandableObject) {

  /** Get ID of expandable {@code quote} object. */

  public String getQuote() {

  }

  public void setQuote(String id) {

  /** Get expanded {@code quote}. */

  public Quote getQuoteObject() {

  }

  public void setQuoteObject(Quote expandableObject) {

  /** Get ID of expandable {@code subscription} object. */

  public String getSubscription() {

  }

  public void setSubscription(String id) {

  /** Get expanded {@code subscription}. */

  public Subscription getSubscriptionObject() {

  }

  public void setSubscriptionObject(Subscription expandableObject) {

  /** Get ID of expandable {@code testClock} object. */

  public String getTestClock() {

  }

  public void setTestClock(String id) {

  /** Get expanded {@code testClock}. */

  public TestClock getTestClockObject() {

  }

  public void setTestClockObject(TestClock expandableObject) {

  /** Get IDs of expandable {@code accountTaxIds} object list. */

  public List<String> getAccountTaxIds() {

  }

  public void setAccountTaxIds(List<String> ids) {

    }

      // noop if the ids are equal to what are already present

    }

  /** Get expanded {@code accountTaxIds}. */

  public List<TaxId> getAccountTaxIdObjects() {

  }

  public void setAccountTaxIdObjects(List<TaxId> objs) {

  /** Get IDs of expandable {@code defaultMargins} object list. */

  public List<String> getDefaultMargins() {

  }

  public void setDefaultMargins(List<String> ids) {

    }

      // noop if the ids are equal to what are already present

    }

  /** Get expanded {@code defaultMargins}. */

  public List<Margin> getDefaultMarginObjects() {

  }

  public void setDefaultMarginObjects(List<Margin> objs) {

  /** Get IDs of expandable {@code discounts} object list. */

  public List<String> getDiscounts() {