Interface PurchasesSubscriptionInfo

Subscription purchases of the Customer.

interface PurchasesSubscriptionInfo {
    billingIssuesDetectedAt: null | string;
    expiresDate: null | string;
    gracePeriodExpiresDate: null | string;
    isActive: boolean;
    isSandbox: boolean;
    originalPurchaseDate: null | string;
    ownershipType: OwnershipType;
    periodType: PeriodType;
    productIdentifier: string;
    purchaseDate: string;
    refundedAt: null | string;
    store: Store;
    storeTransactionId: null | string;
    unsubscribeDetectedAt: null | string;
    willRenew: boolean;
}

Properties

billingIssuesDetectedAt: null | string

Date when RevenueCat detected any billing issues with this subscription. If and when the billing issue gets resolved, this field is set to nil.

expiresDate: null | string

Date when the subscription expires/expired

gracePeriodExpiresDate: null | string

Date when any grace period for this subscription expires/expired. nil if the customer has never been in a grace period.

isActive: boolean

Whether the subscription is currently active.

isSandbox: boolean

Whether or not the purchase was made in sandbox mode.

originalPurchaseDate: null | string

Date when this subscription first started. This property does not update with renewals. This property also does not update for product changes within a subscription group or re-subscriptions by lapsed subscribers.

ownershipType: OwnershipType

How the Customer received access to this subscription:

  • [OwnershipType.PURCHASED]: The customer bought the subscription.
  • [OwnershipType.FAMILY_SHARED]: The Customer has access to the product via their family.
periodType: PeriodType

Type of the current subscription period:

  • [PeriodType.NORMAL]: The product is in a normal period (default)
  • [PeriodType.TRIAL]: The product is in a free trial period
  • [PeriodType.INTRO]: The product is in an introductory pricing period
  • [PeriodType.PREPAID]: The product is in a prepaid pricing period
productIdentifier: string

The product identifier.

purchaseDate: string

Date when the last subscription period started.

refundedAt: null | string

Date when RevenueCat detected a refund of this subscription.

store: Store

Store where the subscription was purchased.

storeTransactionId: null | string

The transaction id in the store of the subscription.

unsubscribeDetectedAt: null | string

Date when RevenueCat detected that auto-renewal was turned off for this subscription. Note the subscription may still be active, check the expiresDate attribute.

willRenew: boolean

Whether the subscription will renew at the next billing period.