Motivation

Populates a new InstallmentInfos object for iOS products with commitments.

Description

Here's what's new:

New APIs

InstallmentsInfo: New class representing the installments that a subscriber commits to when they subscribe to a subscription.

@objc(RCInstallmentsInfo) public final class InstallmentsInfo: NSObject, Sendable {

    /// Number of installments the customer commits to paying.
    @objc public let commitmentInstallmentsCount: Int

    /// Total duration of the customer's installment commitment.
    @objc public let commitmentTotalPeriod: SubscriptionPeriod

    /// Total price the customer commits to paying across all installments.
    @objc public let commitmentTotalPrice: Decimal

    /// Localized display price for ``commitmentTotalPrice``.
    @objc public let commitmentTotalDisplayPrice: String

    /// Price charged for each installment billing period.
    @objc public let installmentBillingPrice: Decimal

    /// Localized display price for ``installmentBillingPrice``.
    @objc public let installmentBillingDisplayPrice: String
}

InstallmentsInfo is then exposed on StoreProduct. It is populated when a product has installments on it, and is nil otherwise.

@objc(RCStoreProduct) public final class StoreProduct: NSObject, StoreProductType {
    @available(iOS 26.4, tvOS 26.4, watchOS 26.4, macOS 26.4, visionOS 26.4, *)
    @objc public var installmentsInfo: InstallmentsInfo?
}

Product Fetching Changes

When fetching products, you can now provide what I'm calling "compound" product identifiers: product identifiers where there's a colon and a string after the base product ID, like how products are represented in BC5, like com.revenuecat.sub:monthly. The portion after the colon represents a product's billing plan. You can fetch them with await Purchases.shared.products([productID]). Here's what can happen when you request the products:

• com.revenuecat.sub: Returns the product with the default billing plan. Today, that always defaults to upFront, so you'll receive one product back with no InstallmentsInfo.
• com.revenuecat.sub:upFront: Returns the product with the upFront billing plan. Since the upFront billing plan has no installments, you'll receive one product back with no InstallmentsInfo.
• com.revenuecat.sub:monthly: Returns the product with the monthly billing plan. Since the monthly billing plan has installments, you'll receive one product back with InstallmentsInfo populated.
  Note that the billing plan lookup is case sensitive, and if the billing plan isn't found, or the user isn't eligible for it, no products will be returned.

Purchase Tester

Added a new screen to the purchase tester to test the Purchases.shared.products([productID]) function directly.

Testing

• Unit tests: we were unit tests for many items including the CompoundProductIdentifier parsing and the InstallmentsInfoFactory.
• Integration tests: Due to a StoreKit bug where products can't be fetched in tests built from Xcode 26.4+ we are unable to write integration tests at this time.
• [Billing Plans]: Introduce Xcode 26.5 build job + handle StoreKitError.paymentMethodBindingConfigurationRequired #6767 will allow us to at least ensure that things compile with Xcode 26.5 :)
• API testers
• Manual testing of products using Purchases.shared.products([productID]) through the purchase tester

We have not yet tested fetching of products with compound product identifiers through the Offerings system. That will come later this week :)