IAP Integration Guide¶

using IntelliVerseX.Monetization;
using UnityEngine;

public class IAPBootstrap : MonoBehaviour
{
    [SerializeField] private IVXIAPConfig _iapConfig;

    private async void Start()
    {
        var result = await IVXIAPManager.Instance.InitializeAsync(_iapConfig);

        if (result.Success)
        {
            Debug.Log($"[IAP] Initialized with {result.ProductCount} products");
        }
        else
        {
            Debug.LogError($"[IAP] Init failed: {result.Error}");
        }
    }
}

var product = IVXIAPManager.Instance.GetProduct("coins_500");
string localizedPrice = product.LocalizedPrice;  // e.g., "$0.99", "€0,99", "¥120"

using IntelliVerseX.Monetization;

public class StoreUI : MonoBehaviour
{
    public async void OnBuyCoins500()
    {
        var result = await IVXIAPManager.Instance.PurchaseAsync("coins_500");

        if (result.Success)
        {
            await IVXWalletManager.Instance.GrantCurrencyAsync("coins", 500);
            ShowPurchaseSuccess("500 Coins added!");
        }
        else if (result.Cancelled)
        {
            Debug.Log("[IAP] User cancelled purchase");
        }
        else
        {
            Debug.LogError($"[IAP] Purchase failed: {result.Error}");
            ShowPurchaseError(result.Error);
        }
    }

    public async void OnBuyRemoveAds()
    {
        var result = await IVXIAPManager.Instance.PurchaseAsync("remove_ads");

        if (result.Success)
        {
            IVXAdsManager.Instance.SetAdsEnabled(false);
            PlayerPrefs.SetInt("ads_removed", 1);
            ShowPurchaseSuccess("Ads removed forever!");
        }
    }
}

public async void OnPurchaseClicked(string productId)
{
    ShowLoadingOverlay(true);

    try
    {
        var result = await IVXIAPManager.Instance.PurchaseAsync(productId);

        if (result.Success)
        {
            var productConfig = _iapConfig.GetProduct(productId);
            await IVXWalletManager.Instance.GrantCurrencyAsync(
                productConfig.RewardType,
                productConfig.RewardAmount
            );
            ShowPurchaseSuccess(productConfig.DisplayName);
        }
        else if (!result.Cancelled)
        {
            ShowPurchaseError(result.Error);
        }
    }
    finally
    {
        ShowLoadingOverlay(false);
    }
}

// Server validation is transparent to the caller
var result = await IVXIAPManager.Instance.PurchaseAsync("coins_500");
// result.Success is only true if server validated the receipt

public async void OnRestorePurchasesClicked()
{
    ShowLoadingOverlay(true);

    var result = await IVXIAPManager.Instance.RestorePurchasesAsync();

    ShowLoadingOverlay(false);

    if (result.Success)
    {
        foreach (var restored in result.RestoredProducts)
        {
            Debug.Log($"[IAP] Restored: {restored.ProductId}");
            ApplyProductReward(restored.ProductId);
        }

        if (result.RestoredProducts.Count > 0)
        {
            ShowToast($"Restored {result.RestoredProducts.Count} purchase(s)");
        }
        else
        {
            ShowToast("No purchases to restore");
        }
    }
    else
    {
        ShowToast($"Restore failed: {result.Error}");
    }
}

private void ApplyProductReward(string productId)
{
    switch (productId)
    {
        case "remove_ads":
            IVXAdsManager.Instance.SetAdsEnabled(false);
            PlayerPrefs.SetInt("ads_removed", 1);
            break;
    }
}

public async void CheckVIPStatus()
{
    var status = await IVXIAPManager.Instance.GetSubscriptionStatusAsync("vip_monthly");

    if (status.IsActive)
    {
        Debug.Log($"[IAP] VIP active until {status.ExpiryDate}");
        EnableVIPFeatures();
    }
    else
    {
        Debug.Log("[IAP] VIP expired or not purchased");
        DisableVIPFeatures();
    }
}

private void OnEnable()
{
    IVXIAPManager.OnSubscriptionRenewed += HandleRenewal;
    IVXIAPManager.OnSubscriptionExpired += HandleExpiry;
}

private void HandleRenewal(SubscriptionInfo info)
{
    Debug.Log($"[IAP] Subscription renewed: {info.ProductId}, next renewal: {info.ExpiryDate}");
    EnableVIPFeatures();
}

private void HandleExpiry(SubscriptionInfo info)
{
    Debug.Log($"[IAP] Subscription expired: {info.ProductId}");
    DisableVIPFeatures();
    ShowRenewalPrompt();
}

private async void Start()
{
    await IVXIAPManager.Instance.InitializeAsync(_iapConfig);

    var vipStatus = await IVXIAPManager.Instance.GetSubscriptionStatusAsync("vip_monthly");
    if (vipStatus.IsActive)
    {
        EnableVIPFeatures();
    }
}

// In IVXIAPConfig:
// Test Mode: ✅

// When test mode is enabled:
// - Purchases succeed immediately without store interaction
// - No real charges occur
// - Receipts are mock-validated
// - Useful for UI testing and development

public async void ShowStarterBundle()
{
    bool hasPurchased = await IVXIAPManager.Instance.HasPurchasedAnyAsync();

    if (!hasPurchased)
    {
        ShowSpecialOffer("starter_bundle_5x", "5x Value! 2,500 coins for $0.99");
    }
}

IVXIAPManager.OnPurchaseCompleted += (purchase) =>
{
    IVXSatoriClient.TrackEvent("iap_purchase", new Dictionary<string, object>
    {
        { "product_id", purchase.ProductId },
        { "product_type", purchase.ProductType.ToString() },
        { "price_usd", purchase.PriceUSD },
        { "currency_code", purchase.CurrencyCode },
        { "is_first_purchase", purchase.IsFirstPurchase }
    });
};

IVXIAPManager.Instance.SetDebugMode(true);
// Logs all store communication, receipt data, and validation results