Skip to content

t1k:unity:tof:iap

FieldValue
Moduletof
Version3.46.8
Effortmedium
Tools—

Keywords: iap, in-app-purchase, receipt-validation, scriptable-object, store

/t1k:unity:tof:iap

Scope — this is a candidate index, not an inventory. This skill indexes one source folder. A feature can span Assets/TheOneFeature/, Packages/com.gdk.*, and sibling Assets/TheOne.* packages, and this skill will only show the folder it was built from. A capability missing here is not evidence that it is absent — verify against source (grep over a stated scope) before concluding anything does not exist. See The1Studio/theonekit-unity#350.

A feature package for In-App Purchase functionality in TheOne framework, providing a standardized interface for managing in-app purchases in Unity mobile games.

⚠️ This skill documents the shop-pack WRAPPER, not the purchase engine. FeatureIAPService / IAPValidator / IapPackDataService sit on top of a separate layer that performs the actual transactions, and that layer is not documented by any tof-* skill:

ConcernWhere
Purchase service interfacePackages/com.gdk.3rd/IAP/IIapServices.cs
Unity IAP implementationPackages/com.gdk.3rd/IAP/UnityIapServices.cs
Purchase restoreUnityIapServices — OnRestorePurchaseCompleteSignal, onRestoreComplete
Receipt data / validation typesPackages/com.gdk.3rd/Contracts/AnalyticServices/Tools/IAPReceiptDataClasses.cs
Purchase signalsPackages/com.gdk.3rd/IAP/Signals/*.cs

Receipt validation and purchase restore both exist. They have been reported absent on the strength of this skill’s silence — read com.gdk.3rd before concluding otherwise. See #350.

  1. Monetization surfaces wire through the interfaces already shipping in the project — never build a mock. Resolve the registered implementation in the composition root and call the interface: IAP via IIapServices (com.gdk.3rd); ads via the registered ad/mediation service; shop / piggy bank / battle pass via the GameFoundation + TOF service each exposes.
  2. Editor/test behaviour is whatever the registered implementation does — the Dummy* binding under a missing define is the editor result; do not mock on top of it.
  3. Never ask “mock, real SDK, or skip”. An unregistered service is fixed by registering the real one, never by stubbing it.

class

  • FeatureIAPService (FeatureIAPService.cs)
  • FeatureIAPVContainer (FeatureIAPVContainer.cs)
  • IAPPackageConfigBlueprint (IAPPackageConfigBlueprint.cs) — CSV-backed config; not IAPPackageConfig (no such type)
  • IAPPackageVisualConfigBlueprint, IAPPackageVisualConfigRecord, IAPPackageVisualRowRecord (IAPPackageVisualConfigBlueprint.cs)
  • IapPackData (IapPacksLocalData.cs)
  • IapPacksLocalData (IapPacksLocalData.cs) — IWritableData, holds the IapPackData records
  • IapPackDataService (IapPackDataService.cs)
  • IapPackSuggestionService (IapPackSuggestionService.cs)
  • IAPValidator (IAPValidator.cs)
  • PurchaseIdAttribute (PurchaseIdAttribute.cs)
  • PurchaseIdDropdownDrawer (PurchaseIdDropdownDrawer.cs)
  • ShopPackReplaceBlueprint (ShopPackReplaceBlueprint.cs)
  • ShopPackReplaceRecord (ShopPackReplaceBlueprint.cs)

None detected.

  • ShopPackReplaceBlueprint
  1. Reference package TheOneFeature in your project.
  2. Register the IAP services via VContainer (see Architecture).
  3. Configure any ScriptableObjects listed in Config section.
  4. Subscribe to signals listed in Signals / Events to react to state changes.

Detected public types (15): class

  • FeatureIAPService (FeatureIAPService.cs)
  • FeatureIAPVContainer (FeatureIAPVContainer.cs)
  • IAPPackageConfigBlueprint (IAPPackageConfigBlueprint.cs) — CSV-backed config; not IAPPackageConfig (no such type)
  • IAPPackageVisualConfigBlueprint, IAPPackageVisualConfigRecord, IAPPackageVisualRowRecord (IAPPackageVisualConfigBlueprint.cs)
  • IapPackData (IapPacksLocalData.cs)
  • IapPacksLocalData (IapPacksLocalData.cs) — IWritableData, holds the IapPackData records
  • IapPackDataService (IapPackDataService.cs)
  • IapPackSuggestionService (IapPackSuggestionService.cs)
  • IAPValidator (IAPValidator.cs)
  • PurchaseIdAttribute (PurchaseIdAttribute.cs)
  • PurchaseIdDropdownDrawer (PurchaseIdDropdownDrawer.cs)
  • ShopPackReplaceBlueprint (ShopPackReplaceBlueprint.cs)
  • ShopPackReplaceRecord (ShopPackReplaceBlueprint.cs)

Detected DI registrations:

  • FeatureIAPService
  • IapPackDataService
  • IapPackSuggestionService
  • PurchaseIdAttribute

Not yet documented. This section was never filled in; it is a known gap, not a statement that the feature has no dependencies. Read the .asmdef next to the source folder above for the authoritative list.

  • Store validation is async; PurchaseIdAttribute must be applied to string fields only.
  • ShopPackReplaceBlueprint uses record types; edits via editor may drop null fields.
  • IAPPackageConfig does not exist — earlier versions of this skill listed it in both Public API and Architecture. The real CSV-backed config type is IAPPackageConfigBlueprint (Core/Features/IAP/Scripts/Models/IAPPackageConfigBlueprint.cs). Verified against source.
  • Restore has an imperative entry point as well as a signal. IIapServices.RestorePurchases(Action onComplete, Action onFail = null) (Packages/com.gdk.3rd/IAP/IIapServices.cs:35) is the call you invoke; the concrete consumer wiring it into game UI/flow is Assets/UITemplate/Sources/Scripts/Modules/Monetize/UITemplateIapServices.cs. Nothing in this package calls restore — do not read that as restore being unimplemented.
  • Source: Assets/TheOneFeature/Core/Features/IAP/
  • Doc: Assets/TheOneFeature/Core/Features/IAP/README.md
  • Doc: Assets/TheOneFeature/Core/Features/IAP/CHANGELOG.md
  • Namespace: TheOne.Features.IAP.Core, TheOne.Features.IAP.Core.DI, TheOne.Features.IAP.Core.Models.Blueprints, TheOne.Features.IAP.Core.Models, TheOne.Features.IAP.Core.Services
  • Purchase restore consumer: Assets/UITemplate/Sources/Scripts/Modules/Monetize/UITemplateIapServices.cs
  • Restore contract: IIapServices.RestorePurchases — Packages/com.gdk.3rd/IAP/IIapServices.cs:35