[Docs] Typo in DiscountOffer type.

[TiPEX360]

Documentation area

openiap.dev

Page or file

https://www.openiap.dev/docs/types/discount-offer

What should be changed?

Docs imply that the DiscountOffer type maps to SubscriptionOfferDetails despite supporting one-time product offers.

Contrastingly, it also points to the native-reference ProductDetails.OneTimePurchaseOfferDetails, confirming it is for a one-time purchase discount.

Furthermore, it says the type is a 'Unified discount-offer type covering both subscription discounts (Introductory, Promotional) and one-time product offers (OneTime, Android only on Google Play Billing Library 8.0+).' This seems correct for Android, but it's worth noting it's also only available on the ProductAndroid type. Perhaps this is in prepartion for one-time offers being available on iOS in the future?

What to change?

This should be cleared up to better convey what the object is really for: one-time product offers and not subscription offers.

Suggested wording or structure

No response

[hyochan]

Confirmed: this was a valid documentation regression rather than a runtime API mismatch.

The production Google mapper builds DiscountOffer only from ProductDetails.OneTimePurchaseOfferDetails and emits the one-time wire type. Subscription introductory/promotional metadata remains a separate SubscriptionOffer contract.

PR #250 fixes the issue comprehensively:

• corrects the canonical DiscountOffer, SubscriptionOffer, product, subscription-product, and purchase-props pages
• migrates the active discount guide to ProductAndroid.discountOffers in all six documented languages
• fixes enum wire values, nullability, native references, canonical search entries, and legacy compatibility wording
• corrects the GraphQL SSOT and regenerates/syncs the SDK comments
• adds regression audits for native mappings, enum values, search routes, and obsolete Kotlin/KMP purchase-call examples

The docs build, 52 GQL tests, 15 focused audit tests, parity/release audits, Flutter analyze, and KMP Android flavor compiles all pass. A real local docs render is attached to the PR.

Implementation: #250