Represents a customer subscription to a subscription plan.
<- Object
Object
Represents a customer subscription to a subscription plan.
For an overview of the Subscription type, see Subscription object.
Read only The ID of the associated subscription plan.
Read only The ID of the associated customer profile.
Read only The start date of the subscription, in YYYY-MM-DD format (for example, 2013-01-15).
The subscription cancellation date, in YYYY-MM-DD format (for example, 2013-01-15). On this date, the subscription status changes to CANCELED and the subscription billing stops. If you don't set this field, the subscription plan dictates if and when subscription ends.
You cannot update this field, you can only clear it.
Read only The date up to which the customer is invoiced for the subscription, in YYYY-MM-DD format (for example, 2013-01-15).
After the invoice is sent for a given billing period, this date will be the last day of the billing period. For example, suppose for the month of May a customer gets an invoice (or charged the card) on May 1. For the monthly billing scenario, this date is then set to May 31.
The tax amount applied when billing the subscription. The percentage is expressed in decimal form, using a '.' as the decimal separator and without a '%' sign. For example, a value of 7.5 corresponds to 7.5%.
Read only The IDs of the invoices created for the subscription, listed in order when the invoices were created (oldest invoices appear first).
A custom price to apply for the subscription. If specified, it overrides the price configured by the subscription plan.
The version of the object. When updating an object, the version supplied must match the version in the database, otherwise the write will be rejected as conflicting.
Read only The timestamp when the subscription was created, in RFC 3339 format.
Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:
UTC: 2020-01-26T02:25:34Z
Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00