NAME

Net::API::Stripe::Billing::Invoice::Period - A Stripe Invoice Period Object

SYNOPSIS

my $period = $invoice_line_item->period({
    end => '2020-12-31',
    start => '2020-01-01',
});

VERSION

v0.100.0

DESCRIPTION

The timespan covered by an invoice item.

This is instantiated from method period in Net::API::Stripe::Billing::Invoice::Item or method period from Net::API::Stripe::Billing::Invoice::LineItem.

CONSTRUCTOR

new( %ARG )

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

METHODS

end integer

End of the line item’s billing period

start integer

Start of the line item’s billing period

API SAMPLE

{
  "id": "in_fake123456789",
  "object": "invoice",
  "account_country": "JP",
  "account_name": "Provider, Inc",
  "amount_due": 8000,
  "amount_paid": 8000,
  "amount_remaining": 0,
  "application_fee_amount": null,
  "attempt_count": 1,
  "attempted": true,
  "auto_advance": false,
  "billing": "charge_automatically",
  "billing_reason": "subscription",
  "charge": "ch_fake123456789",
  "collection_method": "charge_automatically",
  "created": 1507273919,
  "currency": "jpy",
  "custom_fields": null,
  "customer": "cus_fake123456789",
  "customer_address": null,
  "customer_email": "john.doe@example.com",
  "customer_name": null,
  "customer_phone": null,
  "customer_shipping": null,
  "customer_tax_exempt": "none",
  "customer_tax_ids": [],
  "default_payment_method": null,
  "default_source": null,
  "default_tax_rates": [],
  "description": null,
  "discount": null,
  "due_date": null,
  "ending_balance": 0,
  "footer": null,
  "hosted_invoice_url": "https://pay.stripe.com/invoice/invst_fake123456789",
  "invoice_pdf": "https://pay.stripe.com/invoice/invst_fake123456789/pdf",
  "lines": {
    "data": [
      {
        "id": "sli_fake123456789",
        "object": "line_item",
        "amount": 8000,
        "currency": "jpy",
        "description": "1 × Provider, Inc professional monthly membership (at ¥8,000 / month)",
        "discountable": true,
        "livemode": false,
        "metadata": {},
        "period": {
          "end": 1559441759,
          "start": 1556763359
        },
        "plan": {
          "id": "professional-monthly-jpy",
          "object": "plan",
          "active": true,
          "aggregate_usage": null,
          "amount": 8000,
          "amount_decimal": "8000",
          "billing_scheme": "per_unit",
          "created": 1541833564,
          "currency": "jpy",
          "interval": "month",
          "interval_count": 1,
          "livemode": false,
          "metadata": {},
          "nickname": null,
          "product": "prod_fake123456789",
          "tiers": null,
          "tiers_mode": null,
          "transform_usage": null,
          "trial_period_days": null,
          "usage_type": "licensed"
        },
        "proration": false,
        "quantity": 1,
        "subscription": "sub_fake123456789",
        "subscription_item": "si_fake123456789",
        "tax_amounts": [],
        "tax_rates": [],
        "type": "subscription"
      }
    ],
    "has_more": false,
    "object": "list",
    "url": "/v1/invoices/in_fake123456789/lines"
  },
  "livemode": false,
  "metadata": {},
  "next_payment_attempt": null,
  "number": "53DB91F-0001",
  "paid": true,
  "payment_intent": null,
  "period_end": 1507273919,
  "period_start": 1507273919,
  "post_payment_credit_notes_amount": 0,
  "pre_payment_credit_notes_amount": 0,
  "receipt_number": "2066-1929",
  "starting_balance": 0,
  "statement_descriptor": null,
  "status": "paid",
  "status_transitions": {
    "finalized_at": 1507273919,
    "marked_uncollectible_at": null,
    "paid_at": 1507273919,
    "voided_at": null
  },
  "subscription": "sub_fake123456789",
  "subtotal": 8000,
  "tax": null,
  "tax_percent": null,
  "total": 8000,
  "total_tax_amounts": [],
  "webhooks_delivered_at": 1507273920
}

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) 2019-2020 DEGUEST Pte. Ltd.

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