Android Paywalls

import ai.appdna.sdk.AppDNA
import ai.appdna.sdk.paywalls.PaywallContext

AppDNA.presentPaywall(
    activity = this,
    id = "premium_paywall",
    context = PaywallContext(placement = "settings"),
    listener = paywallDelegate,
)

// Present paywall by placement (audience rules determine which paywall to show)
AppDNA.presentPaywallByPlacement(
    activity = this,
    placement = "premium_upgrade",
)

val paywall = AppDNA.paywall

val context = PaywallContext(
    placement = "settings",
    experiment = "paywall_test",
    variant = "b",
)

interface AppDNAPaywallDelegate {
    fun onPaywallPresented(paywallId: String)
    fun onPaywallAction(paywallId: String, action: PaywallAction)
    fun onPaywallPurchaseStarted(paywallId: String, productId: String)
    fun onPaywallPurchaseCompleted(paywallId: String, productId: String, transaction: TransactionInfo)
    fun onPaywallPurchaseFailed(paywallId: String, error: Throwable)
    fun onPaywallDismissed(paywallId: String)
    fun onPromoCodeSubmit(paywallId: String, code: String, completion: (Boolean) -> Unit)
    fun onPostPurchaseDeepLink(paywallId: String, url: String)
    fun onPostPurchaseNextStep(paywallId: String)
    fun onPaywallRestoreStarted(paywallId: String)
    fun onPaywallRestoreCompleted(paywallId: String, productIds: List<String>)
    fun onPaywallRestoreFailed(paywallId: String, error: Throwable)
}

class PaywallHandler : AppDNAPaywallDelegate {

    override fun onPaywallPresented(paywallId: String) {
        Log.d("Paywall", "Paywall shown: $paywallId")
    }

    override fun onPaywallAction(paywallId: String, action: PaywallAction) {
        when (action) {
            PaywallAction.CTA_TAPPED -> Log.d("Paywall", "CTA tapped")
            PaywallAction.FEATURE_SELECTED -> Log.d("Paywall", "Feature selected")
            PaywallAction.PLAN_CHANGED -> Log.d("Paywall", "Plan changed")
            PaywallAction.LINK_TAPPED -> Log.d("Paywall", "Link tapped")
            PaywallAction.CUSTOM -> Log.d("Paywall", "Custom action")
        }
    }

    override fun onPaywallPurchaseStarted(paywallId: String, productId: String) {
        Log.d("Paywall", "Purchase started: $productId")
    }

    override fun onPaywallPurchaseCompleted(
        paywallId: String,
        productId: String,
        transaction: TransactionInfo,
    ) {
        Log.d("Paywall", "Purchased $productId — txn: ${transaction.transactionId}")
        // Paywall auto-dismisses on successful purchase
    }

    override fun onPaywallPurchaseFailed(paywallId: String, error: Throwable) {
        Log.e("Paywall", "Purchase failed: ${error.message}", error)
        // Paywall stays visible so the user can retry
    }

    override fun onPaywallDismissed(paywallId: String) {
        Log.d("Paywall", "Paywall dismissed")
    }

    override fun onPaywallRestoreStarted(paywallId: String) {
        // Show a "Restoring purchases…" toast or spinner
    }

    override fun onPaywallRestoreCompleted(paywallId: String, productIds: List<String>) {
        if (productIds.isEmpty()) {
            // Tell the user there were no purchases to restore
        } else {
            // Refresh entitlements / unlock premium features
        }
    }

    override fun onPaywallRestoreFailed(paywallId: String, error: Throwable) {
        // Surface an error toast — paywall stays visible so the user can retry
    }
}

override fun onPaywallPurchaseFailed(
    paywallId: String,
    error: Throwable,
    errorType: String,
    productId: String?,
) {
    if (errorType == "providerNotAvailable" && productId != null) {
        // e.g. RevenueCat: look up the package for productId and call Purchases.sharedInstance.purchase(...)
        startProviderPurchase(productId) // then close the paywall, e.g. from your provider's success callback
        return
    }
    showError(error)
}

section style.elements.button.container.background.color
  → cta.style.bg_color
    → cta.bg_color
      → your brand accent

"table_columns": ["Free", "Premium"]
"table_columns": [{ "label": "Free" }, { "label": "Premium", "highlighted": true }]

override fun onPromoCodeSubmit(
    paywallId: String,
    code: String,
    completion: (Boolean) -> Unit,
) {
    lifecycleScope.launch {
        try {
            val isValid = MyAPI.validatePromoCode(code)
            completion(isValid)
        } catch (e: Exception) {
            completion(false)
        }
    }
}

import ai.appdna.sdk.AppDNA
import ai.appdna.sdk.paywalls.AppDNAPaywallDelegate
import ai.appdna.sdk.paywalls.PaywallAction
import ai.appdna.sdk.paywalls.PaywallContext
import ai.appdna.sdk.TransactionInfo
import androidx.fragment.app.FragmentActivity

class PremiumGate(
    private val activity: FragmentActivity,
) : AppDNAPaywallDelegate {

    init {
        AppDNA.paywall.setDelegate(this)
    }

    fun showPremiumPaywall(placement: String) {
        AppDNA.presentPaywall(
            activity = activity,
            id = "premium_paywall",
            context = PaywallContext(placement = placement),
            listener = this,
        )
    }

    // MARK: AppDNAPaywallDelegate

    override fun onPaywallPresented(paywallId: String) {
        // Track additional analytics if needed
    }

    override fun onPaywallAction(paywallId: String, action: PaywallAction) {
        // Handle custom actions
    }

    override fun onPaywallPurchaseStarted(paywallId: String, productId: String) {
        // Show loading state if desired
    }

    override fun onPaywallPurchaseCompleted(
        paywallId: String,
        productId: String,
        transaction: TransactionInfo,
    ) {
        unlockPremium()
    }

    override fun onPaywallPurchaseFailed(paywallId: String, error: Throwable) {
        // Error is shown in the paywall UI automatically
    }

    override fun onPaywallDismissed(paywallId: String) {
        // User closed without purchasing
    }

    private fun unlockPremium() { /* ... */ }
}