Understanding the User Transaction List

The user transaction list is divided into two main sections: Details and Transactions. It provides a complete overview of a user’s subscription, including the subscription status, total amount paid, unique identifiers, and a detailed breakdown of all past transactions. This information helps you monitor user activity, understand their purchase behavior, and track any changes to their subscriptions or payment statuses.

Details Section

The Details section includes information about the user’s subscription status, the total amount they’ve paid, and additional unique identifiers.

Subscriptions

1. Country: Shows the App Store country where the user started their subscription. Users who have switched regions will reflect this change. For example, a user may start in the UK and later switch to another country for pricing reasons.

2. Subscription Status:

   • Subscribed & Auto-Renew Enabled: The user has an active subscription, and it will automatically renew. These are the ideal customers.
   • Subscribed & Auto-Renew Disabled: The user has an active subscription but has canceled the future auto-renewal. This means they still have access until the end of the current subscription period, but the subscription will not automatically renew afterward. These users may become inactive once their current period ends.
   • Expired: The user’s subscription has ended, and they didn’t renew. These users no longer have access.
   • Revoked: The user's subscription has been removed/revoked, usually due to the user requesting a refund.
   • Subscribed & Billing Grace Period: The user is subscribed but there is an issue with billing the next subscription payment. The user will stay subscribed for the billing grace period, which you as the app developer set (usually 16 days). If unable to take payment after the grace period they will lose access and be moved to "billing retry".
   • Billing Retry: The user doesn't have access to the subscription due to a billing error. Apple will retry for up to 60 days and then move the user's subscription to "Expired".

See more details with Apple's StoreKit documentation on Subscription Info (opens in a new tab) or on the App Store Server Subscription status API page (opens in a new tab).

Total Paid

This field displays the total amount the user has paid over the course of their subscription, summing up all payments including any changes in plans or App Store regions.

Attributes

• AppAccountToken: This is a unique token representing the user’s account in your app. It helps link transactions and notifications from the App Store to their internal app activity.
• Original Transaction ID: A unique identifier for the initial purchase of a subscription. This ID stays the same throughout the lifecycle of the purchase, even if the user renews or changes their plan.

Transactions Section

The Transactions section lists all the payments the user has made. Each entry includes the following information:

• Price: The amount paid for each subscription period, displayed alongside the total amount if applicable.
• Country: The country associated with the transaction, reflecting where the purchase was made.
• Subscription Plan: The specific plan the user purchased (e.g., yearly or monthly).
• Date: The date of the transaction, renewal, or any other event related to the subscription.

Each transaction is presented in chronological order, making it easy to track the user’s payment history, including any free trials or changes in pricing.