NAME

Net::API::Stripe::Billing::Invoice::LineItem - A Stripe Invoice Line Item Object

SYNOPSIS

VERSION

0.1

DESCRIPTION

CONSTRUCTOR

new( %ARG )

Creates a new Net::API::Stripe objects. It may also take an hash like arguments, that also are method of the same name.

verbose

Toggles verbose mode on/off

debug

Toggles debug mode on/off

METHODS

id string

Unique identifier for the object.

object string, value is "line_item"

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

amount integer

The amount, in JPY.

currency currency

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

description string

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

discountable boolean

If true, discounts will apply to this line item. Always false for prorations.

invoice_item string

livemode boolean

Whether this is a test line item.

metadata hash

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Note that for line items with type=subscription this will reflect the metadata of the subscription that caused the line item to be created.

period hash

The timespan covered by this invoice item.

This is a Net::API::Stripe::Billing::Invoice::Period object.

plan hash, plan object

The plan of the subscription, if the line item is a subscription or a proration.

This is a Net::API::Stripe::Billing::Plan object.

proration boolean

Whether this is a proration.

quantity integer

The quantity of the subscription, if the line item is a subscription or a proration.

subscription string

The subscription that the invoice item pertains to, if any.

subscription_item string

The subscription item that generated this invoice item. Left empty if the line item is not an explicit result of a subscription.

tax_amounts array of hashes

The amount of tax calculated per tax rate for this line item

This is an array of Net::API::Stripe::Billing::Invoice::TaxAmount objects.

tax_rates array of hashes

The tax rates which apply to the line item.

This is an array of Net::API::Stripe::Tax::Rate objects.

type string

A string identifying the type of the source of this line item, either an invoiceitem or a subscription.

unified_proration boolean

For prorations this indicates whether Stripe automatically grouped multiple related debit and credit line items into a single combined line item.

API SAMPLE

{
  "id": "ii_1E9NPMCeyNCl6fY2kwMZb4TN",
  "object": "line_item",
  "amount": -2000,
  "currency": "jpy",
  "description": "Unused time on Angels, Inc entrepreneur monthly membership after 02 Mar 2019",
  "discountable": false,
  "invoice_item": "ii_1E9NPMCeyNCl6fY2kwMZb4TN",
  "livemode": false,
  "metadata": {},
  "period": {
	"end": 1554171359,
	"start": 1551493020
  },
  "plan": {
	"id": "entrepreneur-monthly-jpy",
	"object": "plan",
	"active": true,
	"aggregate_usage": null,
	"amount": 2000,
	"amount_decimal": "2000",
	"billing_scheme": "per_unit",
	"created": 1541833424,
	"currency": "jpy",
	"interval": "month",
	"interval_count": 1,
	"livemode": false,
	"metadata": {},
	"nickname": null,
	"product": "prod_DwjzQmlOcoMCqN",
	"tiers": null,
	"tiers_mode": null,
	"transform_usage": null,
	"trial_period_days": null,
	"usage_type": "licensed"
  },
  "proration": true,
  "quantity": 1,
  "subscription": "sub_EccdFNq60pUMDL",
  "subscription_item": "si_Eccd4op26fXydB",
  "tax_amounts": [],
  "tax_rates": [],
  "type": "invoiceitem"
}

HISTORY

v0.1

Initial version

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Stripe API documentation:

https://stripe.com/docs/api/invoices/line_item

COPYRIGHT & LICENSE

Copyright (c) 2018-2019 DEGUEST Pte. Ltd.

You can use, copy, modify and redistribute this package and associated files under the same terms as Perl itself.